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Manual Objectives 

This manual describes the operation of the Crash Dump Analyzer (CDA). It does not attempt 
to describe the operation of the RSX-llM-PLUS Executive or the significance of the individual 
data structures. The RSX-llM-PLUS and Micro/RSX Executive Reference Manual and the 
RSX-llM-PLUS and Micro/RSX Guide to Writing an I/O Driver describe these data structures. 

Intended Audience 

This manual is intended for system managers who are responsible for interpreting system 
failures and for system operators who run CDA to generate dumps. Understanding CDA output 
requires a working knowledge of assembly language programming and of the Executive data 
structures. 

Structure of Ttils Document 

Chapter 1 explains tiie function of the Crash Dump Analyzer. It tells how to make a crash 
dump driver part of your system, how to get a crash dump, and how to run CDA to get the 
listing. 

Chapter 2 describes the two ways that you can use CDA: by entering the CDA command 
line or by entering the DCL command ANALYZE/CRASH_DUMP. The chapter begins by 
describing the CDA command line format, including command line specifications and switches. 
Two summary tables provide quick reference on switch operation. The chapter concludes with 
a description of the DCL command ANALYZE/CRASH_DUMP. 

Chapter 3 consists of examples and descriptions of CDA output listings. 

Chapter 4 contains helpful hints for interpreting CDA output listings. 

Appendix A contains a short description of each CDA error message. 

Appendix B defines values displayed in the Low Core Memory Dump and in the System 
Common Alphabetized Dump. 

Appendix C lists system macros that supply symbolic offsets for system data structures for 
RSX-llM-PLUS. 

Appendix D lists error code definitions for the Bugcheck facility. 
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Associated Documents 

Refer to the RSX-llM-PLUS Information Directory and Master Index for a brief description of 
each mai\ual in the RSX-llM-PLUS documentation set. 



Conventions Used In Ttiis Document 

The following conventions are used in this manual: 



Convention 
> 



MCR> 
DCL> 
xxx> 
UPPERCASE 



command abbreviations 



lowercase 



Meaning 



A right angle bracket is the default prompt for the Monitor 
Console Routine (MCR), which is one of the command interfaces 
used on RSX-llM-PLUS systems. All systems include MCR. 

A dollar sign followed by a space is the default prompt of 
the DIGITAL Command Language (DCL), which is one of the 
command interfaces used on RSX-llM-PLUS and Micro/RSX 
systems. Many systems include DCL. 

This is the explicit prompt of the Monitor Console Routine 
(MCR). 

This is the explicit prompt of the DIGITAL Command Language 
(DCL). 

Three characters followed by a right angle bracket indicate the 
explicit prompt for a task, utility, or program on the system. 

Uppercase letters in a command line indicate letters that must be 
entered as they are shown. For example, utility switches must 
always be entered as they are shown in format specifications. 



Where short forms of commands are allowed, the shortest form 
acceptable is represented by uppercase letters. The following 
example shows the minimum abbreviation allowed for the DCL 
command DIRECTORY: 

$ DIR 

Any command in lowercase must be substituted for. Usually 
the lowercase word identifies the kind of substitution expected, 
such as a filespec, which indicates that you should fill in a file 
specification. For example: 

filename . filetype ; version 

This command indicates the values that comprise a file spec- 
ification; values are substituted for each of these variables as 
appropriate. 
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Convention 



Meaning 



/keyword, 
/qualifier, 
or 
/switch 

parameter 
[option] 



[..■•] 



{} 
:arguinent 



() 



A command element preceded by a slash (/) is an MCR 
keyword; a DCL qualifier; or a task, utility, or program switch. 

Keywords, qualifiers, and switches alter the action of the 
command they follow. 

Required command fields are generally called parameters. The 
most common parameters are file specifications. 

Square brackets indicate optional entries in a command line or 
a file specification. If the brackets include syntactical elements, 
such as periods (.) or slashes (/), those elements are required for 
the field. If the field appears in lowercase, you are to substitute 
a valid command element if you include the field. Note that 
when an option is entered, the brackets are not included in the 
command line. 

Square brackets around a comma and an ellipsis mark indicate 
that you can use a series of optional elements separated 
by commas. For example, (argument[, . . . ) means that you 
can specify a series of optional arguments by enclosing the 
arguments in parentheses and by separating them with commas. 

Braces indicate a choice of required options. You are to choose 
from one of the options listed. 

Some parameters and qualifiers can be altered by the inclusion 
of arguments preceded by a colon. An argument can be either 
numerical (COPIES:3) or alphabetical (NAME:QIX). In DCL, the 
equal sign (=) can be substituted for the colon to introduce 
arguments. COPIES=3 and COPIES:3 are the same. 

Parentheses are used to enclose more than one argument in a 
command line. 

SET PROT = (S:RWED.O:RWED) 

Commas are used as separators for command line parameters 
and to indicate positional entries on a command line. Positional 
entries are those elements that must be in a certain place in the 
command line. Although you might omit elements that come 
before the desired element, the commas that separate them must 
still be included. 
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Convention Meaning 



[g,in] The convention [g,m] signifies a User Identification Code (UIC). 

[directory] The g is a group number and the m is a member number. The 

UIC identifies a user and is used mainly for controlling access 

to files and privileged system functions. 

This may also signify a User File Directory (UFD), commonly 

called a directory. A directory is the location of files. 

Other notations for directories are: [ggg,mmm], [gggmmm], [ufd], 

[name], and [directory]. 

The convention [directory] signifies a directory. Most directories 

have 1- to 9-character names, but some are in the same [g,m] 

form as the UIC. 

Where a UIC, UFD, or directory is required, only one set of 

brackets is shown (for example, [g,m]). Where the UIC, UFD, 

or directory is optional, two sets of brackets are shown (for 

example, [[g,m]]). 

filespec A full file specification includes device, directory, file name, file 

type, and version number, as shown in the following example: 

DL2 : [46 . 63] INDIRECT . TXT ; 3 

Full file specifications are rarely needed. If you do not provide 
a version number, the highest numbered version is used. If 
you do not provide a directory, the default directory is used. 
Some system functions default to particular file types. Many 
commands accept a wildcard character (*) in place of the file 
name, file type, or version number. Some commands accept a 
filespec with a DECnet node name. 

A period in a file specification separates the file name and file 
type. When the file type is not specified, the period may be 
omitted from the file specification. 

; A semicolon in a file specification separates the file type from 

the file version. If the version is not specified, the semicolon 
may be omitted from the file specification. 

@ The at sign invokes an indirect command file. The at sign 

immediately precedes the file specification for the indirect 
command file, as follows: 

9f ileneune [ . f iletype ; version] 



Convention 



Meaning 



boldface 

italics 
KEYNAME 
"print" and "type" 
black ink 
red ink 



I CTRL/0 1 



A horizontal ellipsis indicates the following: 

• Additional, optional arguments in a statement have been 
omitted. 

• The preceding item or items can be repeated one or more 
times. 

• Additional parameters, values, or other information can be 
entered. 

A vertical ellipsis shows where elements of command input or 
statements in an example or figure have been omitted because 
they are irrelevant to the point being discussed. 

Boldface type indicates that the term is being defined; for 
example, command parameters and glossary entries. 

Italic type indicates emphasis, a book title, or that a new term 
is being used in the text. 

This typeface denotes one of the keys on the terminal keyboard. 
For example, the RETURN key. 

As these words are used in the text, the system prints and the 
user types. 

In examples, what the system prints or displays is printed in 
black. 

In interactive examples, what the user types is printed in red. 
System responses appear in black. 

A symbol with a 1- to 3-character abbreviation, such as or 
He] , indicates that you press a key on the terminal. For example, 
\M indicates the RETURN key. Mi indicates the LINE FEED key, 
and [del] indicates the DELETE key. 

The S5mibol Ictrl/oI means that you are to press th e key marked 
CTRL while pressing another key. Thus, I ctrl/z I indicates that 
you are t o pres s the CTRL key and the Z key together in this 
fashion. |CTRL/z| is echoed on some terminals as "Z. However, 
not all control characters echo. 
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Summary of Technical Changes 



The following sections list features, commands, qualifiers, error messages, and restrictions that 
are new to the Crash Dump Analyzer Utility or have been modified for the RSX-llM-PLUS 
and Micro/RSX Version 4.0 operating systems. These new or modified features are documented 
in this revision of the RSX-llM-PLUS and Micro/RSX Crash Dump Analyzer Reference Manual. 

In addition, major changes to the organization of the manual are included at the end of this 
summary. 

New or Modified Features 

The Crash Dump Analyzer now displays information on cache memory at the time of a system 
failure. 

New or IVIodified Quailflers 

The Crash Dump Analyzer has the following new or modified qualifiers: 

• The /CACHE qualifier to a CDA command or the DCL command ANALYZfe/CRASH_ 
DUMP. 

• The :CSR qualifier to the MCR command SET /CRASH-DEVICE. 

(The :CSR quaUfier is not new to Version 4.0 of RSX-llM-PLUS or Micro/RSX but is 
documented here for the first time.) 

/CACHE 

The /CACHE qualifier produces a listing of information about cache memory at the time of a 
system failure. 



:CSR 

The :CSR qualifier lets you specify a control and status register for the crash dump device, if it 
is not yet installed on your system. 
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New or Modified Error IVIessages 

The CDA produces the following new error messages: 

• Cache region is not in memory. 

• Cache region was not found. 

• Loop found in cache extent descriptors at nnnnn. 

• Loop found in cache statistics blocks at nnnnn. 

• Loop found in linked list in pool at nnnnn. 

• No devices have caching associated with this region. 

• Requested partition is not a cache region. 

Changes to the Document 

Chapter 1 of the RSX-UM-PLUS and Micro/RSX Crash Dump Analyzer Reference Manual has 
been reorganized to reflect the steps needed before you can request crash dumps: loading a 
crash dump driver, obtaining a crash dump after the system fails, and running the CDA program 
to obtain listings of memory at the time of the system failure. 
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Chapter 1 

Preparing for and Running CDA 

The Crash Dump Analyzer (CDA) produces readable listings of the contents of memory after a 
system crash, or faUure. These listings help you track down the cause of the system failure so 
you can fix the problem. The CDA is a nonprivileged task that any user can run. 

AftCT the system fails, you must pass control to a special program called a crash dump driver. 
Section 1.1 tells you how to make such a driver a part of your system? Section 1.2 tells how to 
transfer control to the crash dump driver after a system crash. 

The crash dump driver writes (dumps) the contents of memory onto a disk or tape, which you 
specify, called the crash dump device. Once memory has been dumped, you reboot the system 
and run CDA to format and print the listings. Section 1.3 tells how to run CDA. 

As with all other utilities, you can enter CDA command lines directly from the terminal or from 
an indirect command file. However, CDA indirect command files must not contain a reference 
to another command file. 

1 . 1 Making a Crash Dump Driver Part of Your System 

How you make a crash dump driver part of your system depends on the size of the system. 
A larger system is the non-pregenerated RSX-llM-PLUS system. Smaller systems include 
Micro/RSX and pregenerated RSX-llM-PLUS systems. 

1.1.1 Larger Systems 

For a non-pregenerated RSX-llM-PLUS system, you select one of several available crash dump 
drivers during system generation. See the RSX-UM-PLUS System Generation and Installation 
Guide for instructions. 

Briefly, you select the crash notification device and the aash dump device. The system then 
builds a crash dump driver into the Executive. Thereafter, when the system fails, the aash 
dump driver displays a message on the crash notification device and writes the contents of 
memory onto the specified crash dump device. If you decide to change the crash dump or aash 
notification devices, you must perform another system generation. 
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Since the crash dump driver overwrites the contents of the crash dump device, you should not 
specify the system device as the crash dump device. Also, the following fixed disks cannot serve 
as crash dump devices: RA80, RA81, RD51, RD52, RD53, RD54, and RCF25. Table 1-1 lists 
the devices that can be specified for crash dump devices on non-pregenerated RSX-llM-PLUS 
Systems. 

Table 1 - 1 : Crash Dump Devices for Non-Pregenerated RSX- 1 1 M-PLUS Systems 
Device Mnemonic 



RP04/RP05/RP06 disk packs DB: 

DECtape II (TU58) DO: 

RK05/J/F disk cartridge DK: 

RL01/RL02 disks DL: 

RK06/RK07 disk cartridges DM: 

RM02/RM03/RM05 disk packs DR: 

DECtape (TU56) DT: 

RC25 removable disk pack DU: 

RA60 disk packs DU: 

RX50/RX33 diskette DU: 

RX02 diskette DY: 

TU45/TU16/TE16/TU77 magnetic tapes MM: 

TS11/TU80/TSV05/TK25 magnetic tapes MS: 

TS03/TU10/TE10 magnetic tapes MT: 

TK50 magnetic tapes MU: 



1.1.2 Smaller Systems 

The smaller systems — Micro/RSX operating systems with the Advanced Programmer's Kit and 
pregenerated RSX-llM-PLUS operating systems — support loadable crash dump drivers. You 
can load a driver for a crash dump device while the system is operating. This saves space, as 
you can unload the driver when you do not need crash dump support. Table 1-2 lists the crash 
dump devices you can use with the smaller systems. 
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Table 1-2: Crash Dump Devices for Micro/RSX and Pregenerated RSX-llM-PLUS 
Systems 

Device Mnemonic 



RL01/RL02 disks DL: 

RD51/RD52/RD53/RD54 disks DU: 

RX50/RX33 diskettes DU: 

TSV05/TK25 magnetic tape MS: 

TK50 magnetic tapes MU: 



1.1.2.1 Selecting or Changing a Crash Dump Device 

You select (or change) a crash dump driver with the following DCL command: 

SET SYSTEM /CRASH.DEVICE : ddn : 

If the device is not currently on the system, you use the REGISTER qualifier to specify the 
control and status register (CSR) of the desired device: 

SET SYSTEM /CRASH_DEVICE:d<ln/REGISTER:csraddr 

When the crash driver is successfully loaded, you receive the following message: 

SET — Crash device ddn: has been successfully loaded 

If the device you specified is not in the current system, the following error message is displayed: 

SET — Device not in system 

On RSX-llM-PLUS pregenerated systems, you can also use the following MCR command: 

SET /CRASH_DEVICE:ddnn[:CSRaddr] 

or 

SET /CRASHDEV : ddnn [ : CSRaddr] 

1 . 1 .2.2 Displaying the Current Crash Dump Device 

To display the current crash dump device unit, use the following DCL command: 
SHOW SYSTEM /CRASH_DEVICE 
The system then displays: 
CRASHDEV=ddn: 
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1.1.2.3 Unloading a Crash Dump Driver 

Use the following DCL command to unload a crash dump driver when you no longer want 
crash dump support: 

SET SYSTEM /NOCRASH_DEVICE 

The following MCR command unloads a crash dump driver: 

SET /NOCRASH.DEVICE 

In response, the system displays: 

SET — Crash device ddn: is being unloaded 
SET ~ WARNING, Crash dump support is inactive 

When there is no crash dump driver resident in memory, the Bugcheck facility services system 
crashes. See Appendix D for a list of error code definitions used by Bugcheck. 

1.2 Obtaining a Crasii Dump 

To obtain a crash dump, you must transfer control to the crash dump driver after a system 
crash. Again, the process for doing this depends on the type of system. 

1 .2. 1 Larger Systems 

For non-pregenerated RSX-llM-PLUS systems, transferring processor control to the crash dump 
driver depends on how the failure occurred and whether you built the Executive Debugging 
Tool (XDT) into your system during system generation. System crashes can result from any of 
the following causes: 

• The processor encounters a program condition that causes it to trap to location 40 or to 
XDT. 

• An infinite loop condition occurs. 

• The processor encounters an unintentional HALT instruction in kernel mode (000000). 

1.2.1.1 Processor Trap and Executive Debugging Tooi (XDT) In System 

When a program condition causes a processor trap and XDT is included in your system, control 
transfers automatically to XDT. You can then type X at the console terminal, as follows: 

XDT>X 

This causes XDT to transfer control to the crash dump driver. Refer to the RSX-llM-PLUS and 
Micro/RSX XDT Reference Manual for a description of XDT. 

1.2.1.2 Processor Trap and XDT not In System 

If your system does not include XDT, a processor trap causes control to be transferred directly 
to the crash dump driver. 
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1.2.1.3 HALT or Infinite Loop 

When a system failure is the resuh of a HALT instruction or an infinite loop condition, you 
must restart the processor manually at location 40. 

1 .2. 1 .4 Crash Dump Driver Procedure 

Regardless of how control is transferred, once the processor enters the crash dump routine, the 
routine prints the following informational message on the crash notification device: 

CRASH-CONT WITH SCRATCH MEDIA OH ddim 

After displaying the message, the crash dump routine halts the processor so you can put the 
crash dump device on line. When the device is on line, restart the processor. (For many 
processors, you restart by pressing the CONTINUE switch on the processor console. See the 
PDP-11 Processor Handbook for your processor for specific instructions on how to restart the 
processor.) The crash dump routine then dumps memory on the crash dump device and halts 
the processor when the dump finishes. The volume in the crash dump device now contains a 
binary representation of the contents of memory at the time of the crash. These contents are 
then input to CDA. You can then reboot the system and run CDA to analyze the dump. 

If you specified an illegal device as the crash dump device during system generation (a device 
not listed in Table 1-2), the crash dump driver displays the following message on the crash 
notification device: 

CRASH ~ ILLEGAL CRASH DEVICE 

After displaying the message, the crash dump driver halts. The illegal crash device error occurs 
if you specified a fixed-media device as the crash dump device. If you have a removable media 
device on the same controller, you can switch the physical unit number plugs on the devices 
to assign the removable media device to the crash device. Then press the Continue key on 
the operator console (or other appropriate action to restart your processor) and the crash dump 
driver will attempt the dump again. 

1.2.2 Smaller Systems 

When a Micro/RSX or pregenerated RSX-llM-PLUS operating system crashes, the reaction of 
the system depends on the type of crash support that is loaded when the crash occurs: 

• A crash dump driver is loaded but XDT is not 

• Both a crash dump driver and XDT are loaded 

• XDT is loaded but a crash dump driver is not 
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1.2.2.1 A System Crash with a Driver Loaded and XDT Unioaded 

If a system fails when a crash dump driver is loaded but XDT is not loaded, the crash dump 
routine notifies you of the failure with the following message: 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

After displaying this message, the crash dump driver halts the hardware processor so that you 
can make sure there is a scratch media in the crash device. When you have the crash device 
ready, restart the processor. (For Micro/RSX systems, press the P key followed by a carriage 
return. For other processors, perform the action defined in the PDP-11 Processor Handbook to 
restart. 

In response to your command to proceed, the crash dump driver dumps memory to the 
designated crash dump device. When the dump is completed, the processor is again halted. 
During the memory dump, the processor Run light is on; when the dump is completed, the 
processor Run light goes off. 

At this point, the medium in the crash dump device contains a binary representation of the 
contents of memory at the time the system crash occurred. This memory dump is the input to 
CDA. 

1.2.2.2 A System Crash With a Driver Loaded and XDT Loaded 

If a system fails when a crash driver and XDT are loaded, control is transferred to XDT. After 
you use XDT to debug the system, if you want to obtain a crash dump, press the X key followed 
by a carriage return. The following message is then displayed: 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

Now you can follow the procedure in Section 1.2.2.1 to obtain the crash dump. 

1 .2.2.3 A System Crash With Oniy XDT Loaded 

If a system fails when XDT is loaded but a crash driver is not loaded, control is transferred to 
XDT. However, when you enter the X command, the following is displayed: 

SYSTEM FAULT DETECTED AT PC=xxxxxx FACILITY=xxxxxx ERROR CODE=xxxxxx 
CRASH — CRASH DRIVER NOT LOADED 

There is no recovery from this situation. You may want to reboot the system and duplicate the 
problem with a crash driver installed. 

1.3 Running CDA 

After the crash dump driver has written the contents of memory to the crash dump device, you 
reboot the system and run CDA to obtain its formatted listing of memory. 

There are several ways to run CDA. You can run it as either an installed or an uninstalled task, 
and you can run it from either the DCL or MCR command line interpreter (CLI). This section 
describes the alternative ways of running CDA. 
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1.3.1 CDA Installed and Command Line Interpreter (CU) Is MCR 

If CDA is an installed task on your system, you can enter the CDA command line at the 
CLI prompt. After CDA processes your command, the CLI prompt returns. In the following 
example, MCR is the CLI: 

>CDA CRASH_DUMP.LST, COPY. CDA= [1.54] /STB, DR5: [M] 
> 

1.3.2 CDA Installed and CLI is DCL 

If CDA is installed and you want to enter commands directly to it, invoke the command level of 
the CDA utility by typing CDA and and pressing RETURN. When you are finished using CDA, 
you exit from CDA by pressing CTRL/Z, which returns control to the CU. In the following 
example, DCL is the CLI: 

$ CDA [RETl 
CDA>co]iimand line I RET I 
CDA>coiiuiiand line I RET I 
CDA>-Z 
$ 

1.3.3 CDA Not Installed and CDA.TSK In System Directory 

If CDA is an uninstalled task, the system has to find and install the CDA task image file before 
it can run CDA. Therefore, the command you use depends upon the location of the CDA task 
image file (CDA.TSK). If CDA.TSK is in the system directory, type the following: 

RUN $CDA [BETI 
CDA>coiBmand line I RET I 
CDA> 

1.3.4 CDA Not Installed and CDA.TSK in Directory for Current User 
Identification Code (UIC) 

If CDA.TSK is present in the directory that corresponds to the current UIC on the default system 
device (the current directory for the terminal from which the command is entered), you can run 
CDA by entering the following command: 



RUN CDA IRET] 
CDA>coiimand line I RET I 

1.3.6 DCL Command to Run CDA 

Finally, you can run CDA by using the DCL command ANALYZE/CRASH_DUMP: 
$ ANALYZE/CRASH_DUMP [H] 

If your CLI is MCR, but your terminal also supports DCL, you can enter the ANALYZE 
/CRASH—DUMP command by typing DCL and a space before the command. For example: 

>DCL ANALyZE/CRASH_DUMP [M] 



Chapter 2 shows you how to use CDA command lines and the ANALYZE/CRASH_DUMP 
command. 
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Chapter 2 
Command Lines 



CDA commands control how the Crash Dump Analyzer processes a memory dump and how 
it formats the output listings that it generates. You can use CDA command lines to enter 
commands directly to the CDA utility or, if your terminal supports the DIGITAL Command 
Language (DCL), you can use the DCL command ANALYZE/CRASH_DUMP to run CDA. 
This chapter describes CDA command lines and the ANALYZE/CRASH_DUMP command 
by showing the format of the command lines, the command specifications and qualifiers, and 
examples of how the commands work. 

2.1 CDA Command Lines 

This section shows the CDA command line format, lists and describes command line switches, 
and provides some examples of CDA command lines. 

The CDA command line has the following format: 

CDA> [listfile/sw] , [binaryf ile/sw] = [symbolf ile/STB] , crash-input [/sw] 

The CDA command line specifies the input to CDA and the output from CDA. The specifications 
to the left of the equal sign in the command line are output specifications, and those on the 
right side of the equal sign are input specifications. 

You must include at least one output specification and one input specification in the command 
line. For output from CDA, you can specify a list file only, a binary file only, or both a list 
file and a binary file. For input to CDA, you must specify the crash-input, but the symbol file 
specification is optional. 

Output file specifications are position dependent. Position dependent means that when you 
include both output specifications, you must place them in the positions shown in the command 
line. If you omit the list file, you must place a comma before the binary file specification. 

Input file specifications are position independent and can appear in any order. 

The remainder of this section describes CDA command line specifications. 
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Output Specifications: 

llstflie 

The output specification of the fonnatted CDA analysis listings. You can use either a device 
or a file as the list file specification. If you specify a file, CDA creates the file and writes the 
output listings to the file. By default, CDA then spools the file to the system line printer 
queue, unless you specify otherwise. If you specify a device for the list file, CDA displays 
or prints its output listings on that specific device. For example, if you specify your terminal 
(TTnn: or TI:) as the list file, CDA displays the output listings on your terminal. Chapter 3 
describes the analysis listings that CDA generates. 

blnaryflle 

The file specification for the optional binary file. This file is a copy of the binary data that 
the crash dump routine wrote on the crash dump device. It allows you to selectively create 
a historical record of crash dumps. If you create this file during an initial analysis, you 
can use it for input to CDA at a later time. Since the crash dump routine overwrites the 
information on the crash dump volume with each successive dump, this feature allows you 
to use a single volume for all crash dumps. 

If the crash dump device on your system is a secondary storage or sequential device, you 
can reduce CDA analysis time by copying the crash input to a binary file on another device. 
Then you can use the binary file as input to CDA for analysis. 

input Specifications: 

symbolfile/STB 

The file specification of the symbol table file for the crashed system. The /STB switch is an 
integral part of this file specification because CDA uses the data in the symbol table file to 
format the binary memory dump into readable formats. If you omit this file specification 
and switch, CDA uses the default symbol table file, which is the file named RSXllM.STB 
in the directory that corresponds to the current UIC. 

crash-input 

The source of the binary input to CDA. This specification can be either a device name 
(the crash dump device) or a binary file that was created during a previous CDA analysis. 
However, if the crash-input specification is a binary file, you cannot also include a binary 
file output specification in the command line. 

Switches: 

/sw 

An optional CDA sv^ritch. The list file, binary file, and crash-input file specifications can 
include optional switches that modify CDA action. Each specification in the command line 
has its own switches. Section 2.1.1 describes the CDA switches and lists the specification 
to which they apply. 
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File specifications in the CD A command line can appear in complete Files- 11 format, with 
device name, directory, file name, file t5^e, and version number. When you omit any of these 
elements, CDA uses the defaults shown in Table 2-1. However, not all of the elements in file 
specifications have defaults. 



Table 2-1: File Default Values 



File 



Default Value 
Device Directory File Name File Type 



Ust file 


SY: 


Current 


None 


.LST 


Binary file 


SY: 


Current 


None 


.CDA 


Symbol file/STB 


SY: 


Current 


RSXllM 


.STB 


Crash-input 


SY: 


Current 


None 


.CDA 



See Section 2.1.2 for examples of CDA command lines, which include examples that show how 
CDA uses default file types. 

2.1.1 CDA Command Line Switches 

Two kinds of command line switches — analysis switches and function switches — allow you 
to control CDA operation. 

Analysis switches determine which analysis routines CDA applies to the crash input. Thus, you 
can select the types of data that you want CDA to output. For example, analysis switches can 
list information about all of the devices in the system, or they can list information about active 
devices only. 

Function switches provide a number of options for controlling CDA output. For example, 
function switches can terminate an analysis after CDA encounters a specified number of errors, 
or they can limit the number of pages of output listings. 

Both types of switches are file specific. That is, each switch applies to a particular file and may 
not be used without that file or with any other file. 

2. 1 . 1 . 1 Analysis Switches 

Table 2-2 summarizes the analysis switches and gives brief descriptions of their effects. Some 
of the switches in Table 2-2 have sjmonjrms or alternate mnemonics. These are shown under 
each switch. Expanded descriptions of each switch follow the table. 

Table 2-2: Summary of CDA Analysis Switches 



Switch 



Function 



Applies to File 



/ACT 
/ATL 

/ADV 



List the contents of the Task Contirol Block (TCB) Crash-input 
for each active task 



Lists information for all devices in the system 



Crash-input 
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Table 2-2 (Cont.): Summary of CDA Analysis Switches 



Switch 



Function 



Applies to File 

Crash-input 
Crash-input 
Crash-input 

Crash-input 
Crash-input 
Crash-input 



Crash-input 

Crash-input 
Crash-input 

Crash-input 

Crash-input 

Crash-input 
Crash-input 

Crash-input 
Crash-input 

Crash-input 



/ALL 

/CACHE[:[region]] 

/CLI 
/CPB 

/CLQ 

/CTL 

/DEV 
/DCB 
/SCB 
/UCB 

/DUMP:a:b:[c] 
/DMP:a:b:[c] 

/HDR 

/KDS:a:b 

/KIS:a:b 



/PCB 
/PAR 

/POOL 

/SECPOL[:a:b] 

/-SYS 

/TASK:name:a:b 

/TAS:name:a:b 

/TSK:name:a:b 

/TCB 
/TAL 
/STD 

/TDS:name:a:b 



Lists the output of all analysis routines 

Lists information on cache region 

List the contents of the CLI Parser Blocks in the 
system 

Lists the contents of the clock queue 

Lists information for each device controller 

List information for all active devices in the system 



List the contents of physical memory between 
address a and address b; (c is an optional virtual 
starting address) 

Lists the contents of the task headers for each task 
resident in memory 

Lists the contents of the kernel data space 
from virtual address a to virtual address b 
(RSX-llM-PLUS systems only) 

Lists the contents of kernel instruction space 
from virtual address a to virtual address b 
(RSX-llM-PLUS systems only) 

List the contents of each Partition Control Block 

Lists the contents of the system's pool 

Lists the contents of system secondary pool 
(RSX-llM-PLUS systems only) 

Suppresses listing of the system information 

List the contents of task "name" between virtual 
address a and virtual address b; list the contents 
of task data space (if task includes data space) on 
RSX-llM-PLUS 

List the contents of the TCB for every task in the 
System Task Directory 



Lists the contents of task data space (RSX-llM-PLUS Crash-input 
only) 
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Table 2-2 (Cont.): Summary of CDA Analysis Switches 



Switch Function Applies to File 

/TIS:name:a:b Lists the contents of task instruction space Crash-input 
(RSX-llM-PLUS systems only) 

/ACT or /ATL (Task Control Blocks for Active Tasks) 
File: Crash-input 

Effect: CDA lists the contents of the Task Control Block (TCB) for each active task. 

/ADV (All Devices) 
File: Crash-input 

Effect: CDA lists the contents of the control blocks for all devices in the system. To list 
active devices, use the /DEV switch. 

/ALL (Ali Analysis Routines) 
File: Crash-input 

Effect: CDA applies all of its analysis routines (except those associated with memory and 
task dumps) to the specified crash-input. The output from these routines is listed in the 
following order: 

1. System information 

2. Active tasks information 

3. Task headers information 

4. Partition information 

5. Common Block Directory entries 

6. Device information 

7. Clock queue contents 

8. Device controller information 

9. Pool contents 

10. Cache region listing 

/CACHE[:[reglon]] (Cache Memory) 
File: Crash-Input 

Effect: CDA lists information about the contents of cache memory at the time of the dump. 
The region is the name of the cache region specified in the SET CACHE command or the 
MOUNT command with the CACHE qualifier. 

/CLI or /CPB (Command Line Interpreter Parser Blocks) 
File: Crash-input 
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Effect: CDA lists the contents of all Command Line Interpreter Parser Blocks (CPBs) in the 

system. 

/CLQ (Clock Queue) 
File: Crash-input 

Effect: CDA lists the contents of the clock queue. 

/CTL (Device Controllers) 
File: Crash-input 

Effect: CDA lists the contents of the controller table and Controller Request Block (KRB) 
for each device controller in the system. 

/DEV, /DCB, /SCB, or /UCB (Devices in System) 
File: Crash-input 

Effect: CDA scans the system device tables and lists the contents of the control blocks for 
each active device in the system. To list all devices, use the /ADV switch. 

/DUMP:a:b:[c] or /DIVIP (Physicol Memory) 
File: Crash-input 

Effect: If only a and b are specified, CDA dumps the contents of physical addresses a 
through b, inclusive, and labels them with their physical addresses. If a, b, and c are 
specified, CDA dumps the contents of physical addresses a through b but labels them with 
dummy virtual addresses, starting at the address specified by c. 

CDA allows you to specify a virtual starting address because RSX-llM-PLUS and 
Micro/RSX systems use physical memory in terms of virtual addresses. If you dump 
physical memory labeled with the corresponding virtual addresses, you do not have to 
translate physical addresses to virtual addresses as you read the dump. 

/HDR (Heoders for IVIemory-Resident Tasks) 
File: Crash-input 

Effect: CDA lists the contents of the task headers for each task resident in memory. 

/KDS:a:b (Kernel Data Space) 
File: Crash-input 

Effect: CDA lists the contents of kernel data space between the virtual addresses a and b, 
inclusive. 

/KIS:a:b (Kernel Instruction Space) 
File: Crash-input 

Effect: CDA lists the contents of kernel instruction space between the virtual addresses a 
and b, inclusive. 

/PCB or /PAR (Partitlor^ Control Blocks) 
File: Crash-input 
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Effect: CDA outputs a map that lists all the occupants of memory and the contents of each 
Partition Control Block (PCB). 

/POOL (System Pool) 
File: Crash-input 

Effect: CDA lists the system pool in octal, Radix-50, and ASCII. 

/SECPOL[:a:b] (Secondary Pool) 
File: Crash-input 

Effect: Lists the contents of the secondary pool on RSX-llM-PLUS systems. 

/STD, /TCB, or /TAL (System Task Directory) 
File: Crash-input 

Effect: CDA lists the contents of all of the Task Control Blocks in the System Task Directory 
(STD) at the time of the crash. 

/-SYS (System Information) 
File: Crash-input 

Effect: CDA suppresses the system information listing. 

/TASK:name:a:b, /TAS, or /TSK (Task Virtual Address Space) 
File: Crash-input 

Effect: CDA lists the virtual address space from the 16-bit virtual address a through b for 
the task specified by "name." If you do not specify addresses, CDA lists the task's entire 
virtual address space. 

/TDS:name[:a:b] (Task Data Space) 
File: Crash-input 

Effect: CDA lists the contents of the task data space between the virtual addresses a and b, 
inclusive. If you do not specify addresses, CDA lists the entire task data space. 

/TIS:name:a:b (Task Instruction Space) 
File: Crash-input 

Effect: CDA lists the contents of the task instruction space between the virtual addresses 
a and b, inclusive. If you do not specify addresses, CDA lists the entire task instruction 
space. 

2.1.1.2 Function Switches 

Table 2-3 summarizes the function switches and gives brief descriptions of their effects. 
Expanded descriptions of each switch follow the table. 
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Table 2-3: Summary of CD A Function Switches 



Applies 
Switch Function to File Default^ 

/BL:n Identifies the starting block number of the crash- Crash-input n=l 

input device; the value of n must be less than 
65535 

/DENS:n Sets density of crash input tape to 800 or 1600 Crash-input n=800 
:H1GH bits per inch (bpi) 
:LOW 

/EXIT:n Terminates analysis after encountering n analy- List file 

sis errors 

/LlMlT:n Limits output hsting to n pages List file n=300. 

/LlNES:n Limits page length to n lines List file n=60. 

/MEMSlZ:n Saves nK words of memory from crash in a Binary file n=124. 
binary file 

/KMR Forces the assignment of kernel address register Crash-input /-KMR 

values for the crashed system 

/-SP Does not print analysis output listing List file /SP 

/STB Identifies the file specification that contains the Symbol file 

Executive symbol table 

n can be expressed as an octal or decimal number. A decimal point (.) following the number denotes decimal. 

/BL:n (Identify Starting Block Number) 
File: Crash-input 

Effect: CDA reads the dump from the input device beginning at block n. If the crash dump 
device is not a disk or a DECtape, CDA ignores this switch. 

Default: n = 1 

/DENS:n (Set Tope Density) 
:HIGH 
:LOW 

File: Crash-input 

Effect: CDA reads the crash input tape at the density specified: 800 or 1600 bpi. You can 
also use LOW to indicate 800 bpi or HIGH to indicate 1600 bpi. 

Default: n=800 

/EXIT:n (Exit After n Errors) 
File: List file 
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Effect: CDA maintains an error count. As it encounters inconsistencies in the system data 
structures, it increments this count. If you specify the /EXIT:n switch, CDA terminates 
analysis after n errors. If you specify the /EXIT switch but do not specify n, CDA exits 
after one error. 

Default: CDA runs to completion. 

/LIMIT:n (Limit Output Listing) 
File: Ust file 

Effect: The /LIMIT:n switch limits the number of pages of analysis output. When CDA 
has generated n pages, it terminates the analysis and prints a message on the user terminal 
indicating that it has done so. 

Default: n = 300. 

/LINES:n (Print n Lines per Page) 
File: List file 

Effect: This switch lets you specify the number of lines you want CDA to print per page. 
After n lines are printed, a new page is ejected. 

Default: n=60. 

/MEIVISIZ:n (Estabiish Size of Binary Output File) 
File: Binary file 

Effect: This switch causes CDA to create a binary output file 4n blocks long and to transfer 
nK words to it from the crash-input file. The value of n must be greater than 16. 

This switch is particularly useful when transferring binary crash dumps from disk or 
DECtape. Since disks and DECtapes have no physical end-of-files (EOFs), it is necessary to 
specify the size of the actual memory dump. 

When the crash input resides on magnetic tape, the binary output file is filled with zeroes 
if the EOF is read before nKb words are transferred. 

Default: n = 124. 

/KIVIR (Assign Kernel Mapping Register Values) 
File: Crash-input 

Effect: On mapped systems, when CDA reads incorrect Page Address Register (PAR) values 
from the crash stack, it aborts the analysis and prints an error message on the terminal. If 
this happens, you can use the /KMR switch to retry the analysis. When you specify /KMR, 
CDA uses standard mapping values to convert kernel virtual addresses to physical memory 
addresses. 

Default: CDA uses existing Page Address Registers. 

/-SP (Do Not Spool) 
File: List file 
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Effect: CDA does not spool the analysis output listing to the system line printer queue. 
Instead, it creates an output list file on the device indicated in the output file specification. If 
you do not specify a device in the output file specification when you use the /-SP qualifier, 
CDA creates the output list file on SYO:. 

Default: /SP 

/STB (File Specified Contains the Executive Symboi Tabie) 
FUe: Symbol file (RSXllM.STB) 

Effect: The /STB switch identifies a file containing the Executive symbol table. This file 
must correspond to the failed system. CDA opens the symbol file and extracts the necessary 
symbol values. If it fails to find any required symbol values, CDA aborts the analysis and 
returns an error message. 

Default: [current UIC]RSX1 IM.STB 

2. 1 .2 CDA Command Line Examples 

The following examples illustrate CDA command lines. Assume that the user in these examples 
is logged in under UlC [301,356], that the crash dump device is DR5:, and that CDA is running 
as an installed task. Also, note how CDA uses default file types. 

Example 1 

>CDA[REf] 

CDA>DUMP , DUMP=RSX1 IM . STB/STB . DR5 : ^] 

This command line creates: 

• A list file, DUMP.LST, in directory [301,356], which is printed automatically 

• A binary file, DUMP.CDA, in directory [301,356] 

CDA reads the binary crash dump input from the crash dump device (DR5:), makes a binary 
copy of the crash dump input named DUMP.CDA, analyzes the crash dump input according to 
the information in the Executive symbol table file named RSXllM.STB in directory [301,356], 
and writes a formatted output listing to a file named DUMP.LST. CDA then spools DUMP.LST 
to the system line printer queue. 



Example 2 

>CDA [Ml 

CDA> . DUMP= [1 ,54] /STB , DR5 : JRET] 

This command line creates a binary file named DUMP.CDA in directory [301,356]. 

CDA reads the binary crash dump input from DR5: and analyzes it according to the information 
in the Executive symbol table file, which is named RSXllM.STB in directory [1,54]. 
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Example 3 

>CDA LP : = [1.64] /STB. DUMP [RETl 
> 

This command line creates an output listing on device LP:. 

CD A reads the binary input from a previously created binary file named DUMP.CDA and 
analyzes it in accordance with the information contained in the Executive symbol table file 
named RSXllM.STB in directory [1,54]. The CDA output listings are then printed on LP:. 

This command line is also an example of a CDA command that is issued from the CLI prompt. 
Thus, the CLI prompt returns after the command is issued.. 

Example 4 

>CDA TI:=DUMPfRET] 
> 

This command line creates an output listing that is displayed on the terminal from which the 
command was issued. 

CDA reads the binary input from a previously created binary file named DUMP.CDA and 
analyzes it according to the information in the default symbol table file, (the file named 
RSXllM.STB in the directory that currently corresponds to UIC [301,356]). The CDA output 
listings are then displayed on TI. 

2.2 The DCL Command ANALYZE/CRASH_DUMP 

If your terminal supports the DIGITAL Command Language (DCL) command line interpreter, 
you can run the CDA utility by using the DCL command ANALYZE/CRASH -DUMP as an 
alternative to the CDA command line. This section describes the ANALYZE/CRASH_DUMP 
command line format and qualifiers. The section concludes with some examples of ANALYZE 
/CRASH_DUMP command lines. 

The ANALYZE/CRASH_DUMP command line has the following format: 

ANALYZE/CRASH_DUMP [/qualifiers] crash-input [/qualifiers] 

You use the ANALYZE/CRASH_DUMP command to specify CDA input and output. The 
command qualifiers that you place immediately after the command name specify the CDA 
output files and, optionally, the symbol table file that CDA uses to process the crash dump 
input. The crash-input specification is mandatory because it directs CDA to the source of the 
binary crash dump input. 

Output Specifications: 

You must specify at least one of the following command qualifiers as an output specification in 
the command line: 

• /LIST: Specifies the output list file 

/BINARY: Specifies a binary copy of the crash-input file 

• /SYMBOLS: Specifies the symbol definition file 
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You can specify /LIST: only, /BINARY: only, or /LIST: and /BINARY: together. Optionally, 
you can specify /SYMBOLS: with any combination of the /UST: and /BINARY: qualifiers. 
However, if you do specify /SYMBOLS, you must include at least one of the other command 
qualifiers (the symbol definition file is not an output file; rather, it is used by CDA to generate 
an output file). Section 2.2.1.1. provides complete descriptions of the functions of each of the 
command qualifiers. 

If you omit the crash-input specification from the command line, CDA prompts you for it, as 
shown in the following example: 

$ ANALYZE/CaiASH_DUMP/LIST:LP: mi] 
Crash input? DR5: Ull] 

If you enter the command name only, CDA prompts you for input and output, as shown in the 
following example: 



$ ANALYZE/CRASH.DUMP IMJ 

Crash output? /LIST : SY: [301, 356] CRASH. LST: /BINARY: COPY. CDA [M] 

Crash input? DUMP. CDA [Ml 

Note that, if you enter an output file in this way, you must include the /LIST: or /BINARY: 

qualifiers as part of the output file specification. 

Input Specification: 

crash-input 

Specifies the location of the binary input to the ANALYZE/CRASH_DUMP command. The 
crash-input specification can be the name of the crash dump device, or it can be a binary 
file that was created during a previous crash dump analysis. 

When you enter an ANALYZE/CRASH -DUMP command line, you can include command 
qualifiers, qualifiers for the crash-input parameter, or both. Section 2.2.1 describes qualifiers. 

2.2.1 ANALYZE/CRASH-DUMP Command Qualifiers 

You can control the way CDA processes the crash input and how it formats the output listings 
by using command qualifiers in the command line. You can select the information that you 
want in the CDA output listings by using qualifiers for the crash-input specification. Section 
2.2.1.1 describes command qualifiers. Section 2.2.1.2 describes the qualifiers that you can use 
when you specify the crash input. 

2.2.1.1 Command Qualifiers 

You can use command qualifiers with the ANALYZE/CRASH-DUMP command to control how 
CDA processes the binary crash-input and how it formats the output analysis listings. You place 
command qualifiers immediately after the command name in the command line. Table 2-4 
summarizes the command qualifiers and gives brief descriptions of their effects. Expanded 
descriptions of each qualifier follow the table. 
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Table 2-4: Summary of ANALYZE/CRASH_DUMP Command Qualifiers 



Command Qualifier 


Function 


Applies to 
File 


/LIST:listfile[/qualifiers] 


Specifies the output list file or device 


List file 


listfile qualifiers: 






/ERROR-LIMIT 


Specifies an error limit at which CDA analysis 
terminates 


List file 


/PAGE_COUNT:n 


Specifies the number of output pages 


List file 


/PAGE_LENGTH:n 


Specifies the number of output lines per page 


List file 


/[N0]PR1NTER 


Specifies whether the output should be printed 
on the system line printer 


List file 


/BlNARY:binaryfile[/qual] 


Specifies an optional copy of the binary input 
file 


Crash-input 


binaryfile qualifier: 






/MEMORY_SIZE:n 


Copies nK words of memory from a crashed 
system 


Crash-input 


/SYMBOLS:symbolfile 


Specifies the symbol definition file 


Crash-input 



Command Qualifier Descriptions: 

/LIST:llstflle[/quallflers] 

/ERROR_LIMIT[:n] 
/PAGE_COUNT:n 
/PAGE_LENGTH:n 
/[NO]PRINTER 

File: List file 

Effect: Specifies the optional formatted CDA output list file. This list file consists of the 
analysis report listings that are described in Chapter 3. You can also specify a device for 
the Ust file, in which case CDA displays or prints its output listings on the specified device. 
You can control the list file output by using the following file qualifiers. 

List File Qualifiers: 

/ERROR_LIMIT[:n] 

Effect: CDA maintains an error count. As it encounters inconsistencies in the system data 
structures, it increments the error count. CDA terminates the crash dump analysis when it 
finds the number of errors that you specify with this qualifier. If you use the /ERROR- 
LIMIT qualifier without specifying a number, the crash dump analysis terminates after one 
error. 

Default: CDA runs the analysis until it is completed. 
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/PAGE_COUNT:n 

Effect: This qualifier limits the number of pages of analysis output. When CDA has 
generated n pages, it terminates the analysis and prints a message on the terminal indicating 
that the analysis has terminated. 

Default: Analysis terminates after 300 pages. 

/PAGE_LENGTH:n 

Effect: This qualifier lets you specify the number of lines that you want CDA to print per 

output page. After the specified number of lines are printed, CDA breaks to a new page. 

Default: CDA prints 60 lines per page. 

/[NO]PRINTER 

Effect: This qualifier prevents the printing of the analysis output on the system line printer. 
Instead, CDA creates the output list file on the device in the list file specification. If a device 
is not specified in the list file specification, CDA creates the output file on the default user 
disk (SYO:). 

Default: CDA prints all output on the system line printer. 

/BINARY:binarYflle[/qualifler] 

/MEMORY_SIZE:n 
File: Crash-input 

Effect: Specifies that an optional binary file should be created. This file is a copy of the 
binary data that the crash dump routine wrote on the crash dump device. If you create the 
file during an initial analysis, you can use it as input to the ANALYZE/CRASH_DUMP 
command at a later time. Also, because the crash dump routine overwrites the contents of 
the crash dump volume with each crash dump, this qualifier allows you to save the results 
of crash dumps. You can then reuse the same volume for successive crash dumps while 
maintaining a record of previous crash dumps. 

Binary File Qualifier: 

/MEMORY_SIZE:n 

Effect: Specifies memory size for the binary copy of the crash dump input file. You specify 

n, where n is the number of K words. CDA then creates a binary file 4n words long and 

transfers nK words to it from the crash-input file. The value of n must be greater than 

16(dedmal). 

Default: n=124 

/SYMBOLS:symbolflle 

File: Symbol definition file 

Effect: Specifies the symbol definition file for the failed system, which contains the Executive 
symbol table. The symbol file must correspond to the failed system. CDA opens the file 
and extracts the necessary symbol values. If it fails to find any required symbol values, CDA 
aborts the analysis and returns an error message. If you omit this file specification, CDA 
uses the default file, which is the file named RSXllM.STB in the directory that corresponds 
to the current UIC. 
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2.2.1.2 Crash-input File Quaiifiers 

You can select the analysis listings that you want CDA to output by using qualifiers for the 
crash-input file specification in the ANALYZE/CRASH_DUMP command line. Table 2-5 
summarizes the crash-input qualifiers and gives brief descriptions of their effects. Expanded 
descriptions of each qualifier follow the table. 

Table 2-5: Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers 



Qualifier or Argument 



Function 



Applies to 
File 



/ACTIVE:(arg[, . . . ]) 

/ACTIVE arguments: 
DEVICES 
TASKS 

/ALL 

/BLOCK:n 

/CACHE[:[region]] 

/CLOCK_QUEUE 

/CONTROLLERS 
/DATA_STRUCTURES:(arg[, . . . ]) 

/DATA_STRUCTURES arguments: 
COMMAND-PARSER 

DEVICE 
STATUS 
UNIT 

PARTITION 
TASK 
/DENSITY:n 



Lists data on active tasks and/or Crash-input 
devices 



Lists data about active devices Crash-input 

Lists contents of the Task Control Crash-input 
Blocks for active tasks 

Lists all available crash dump Crash-input 
data 

Specifies the block number where Crash-input 
crash dump begins on the crash 
dump device 

Lists information about cache Crash-input 
memory at the time of the dump 

Lists the contents of the clock Crash-input 
queue 

Lists device controller data Crash-input 

Specifies which data structures Crash-input 
are to be formatted and listed 



Lists contents of CLI Parser Crash-input 
Blocks 

List contents of the control blocks Crash-input 
for active devices 



Lists contents of Partition Control Crash-input 
Blocks 

Lists contents of the Task Control Crash-input 
Blocks for tasks in the STD 

Specifies bits per inch for input Crash-input 
device 
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Table 2-5 (Cont.): Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers 



Qualifier or Argument 



Function 



Applies to 
File 



/DEVICES 

/DUMP[:(START:n,END:n,ADDRESS:n)] 

/HEADERS 

/KERNEL:(arg[, . . . ]) 

/KERNfEL arguments: 
DATA:(START:n,END:n) 
INSTRUCTION:(START:n,END:n) 

REGISTERS 

/PARTITION 

/POOL 

/SECOND ARY_POOL[:(START:n,END:n)] 

/[NO]SYSTEM 

/TASKS:(arg[, . . . ]) 
/TASKS arguments: 
DIRECTORY 

ADDRESS:(NAME:name[,START:n,END:n]) 

DATA:(NAME:name[,START:n,END:n]) 
INSTRUCTION:(NAME:[,START:n,END:n]) 



Lists contents of all Device Control Crash-input 
Blocks 

Lists contents of physical ad- Crash-input 
dresses 

Lists contents of resident task Crash-input 
headers 

Lists kernel contents Crash-input 

Lists contents of kernel data space Crash-input 

Lists contents of kernel instruc- Crash-input 
tion space 

Forces assignment of values for Crash-input 
the kernel address registers 

Lists contents of Partition Control Crash-input 
Blocks 

Lists pool contents Crash-input 

Lists contents of secondary pool Crash-input 
from START to END 

Suppresses listing of system in- Crash-input 
formation 

Lists task data Crash-input 



Lists contents of the Task Control Crash-input 
Blocks for tasks in the STD 

Lists contents of task addresses Crash-input 
from START to END 

Lists contents of task data space Crash-input 

Lists contents of task instruction Crash-input 
space 



File Qualifier Descriptions: 

/ACTIVE:(arg[, . . . ]) 
DEVICES 
TASKS 
File: Crash-input 
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Effect: Lists data on active tasks and devices. 
/ACTIVE arguments: 

DEVICES 

Effect: Lists data on the devices active in the system at the time of the crash. If you want 
CDA to list data on all of the devices known to the system at the time of the crash, use the 
/DEVICES qualifier. 

TASKS 

Effect: Lists the contents of the Task Control Blocks of active tasks. If you want CDA to 
list the contents of the Task Control Blocks of all installed tasks, both active and dormant, 
use the /TASKS:(DIRECTORY) qualifier. 

/ALL 

File: Crash-input 

Effect: Analyzes all information available in the crash dump file (except the information 
associated with memory and task dumps). CDA lists the output in the following order: 

1. System information 

2. Active tasks information 

3. Task headers information 

4. Partition information 

5. Common Block Directory entries 

6. Device information 

7. Clock queue contents 

8. Device controller information 

9. Pool contents 

10. Cache region listing 

/BLOCK:n 

File: Crash-input 

Effect: Identifies the starting block number of the crash dump file on the crash input device. 
The value of n must be less than 65535io. 

/CACHE[:[reglon]] 
File: Crash-input 

Effect: Lists information about cache memory at the time of the dump. The region is the 
name of the cache region as specified in the SET CACHE command or in the MOUNT 
command with the CACHE qualifier. 

/CLOCK-QUEUE 

File: Crash-input 
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Effect: Lists the contents of the system clock queue. 

/CONTROLLERS 

File: Crash-input 

Effect: Lists the contents of the controller table and Controller Request Block (KRB) for each 
device controller in the system. 

/DATA_STRUCTURES:(arg[, . . . ]) 

COMMANDPARSER 
DEVICE 
PARTITION 
STATUS 
TASK 
UNIT 
File: Crash-input 

Effect: Selects which system data structures CDA will format and list. 
/DATA-STRUCTURES arguments: 

COMMAND-PARSER 

Effect: Lists the contents of the Command Line Interpreter (CLI) Parser Blocks. 

PARTITION 

Effect: Lists the contents of the Partition Control Blocks. 

TASK 

Effect: Lists the contents of the Task Control Block for every task in the System Task 
Directory (all installed tasks) at the time of the system crash. 

DEVICE 

Effect: Lists the contents of the Device Control Blocks for active devices. 

STATUS 

Effect: Lists the contents of the Status Control Blocks for active devices. 

UNIT 

Effect: Lists the contents of the Unit Control Blocks for active devices. 

/DENSITY:n 

File: Crash-input 

Effect: Causes a crash input tape to be read at the density specified, 800 or 1600 bpi. The 
default is 800 bpi. 

/DEVICES 

File: Crash-input 

Effect: Lists the contents of the control blocks for all devices in the system. To list only 
active devices, use the /ACT1VE:(DEV1CES) qualifier. 
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/DUMP[:(START:a,END:b[,ADDRESS:c])] 
File: Crash-input 

Effect: Lists the contents of physical addresses a through h, inclusive, and labels them with 
their physical addresses. If you include address c, the /DUMP qualifier dumps the contents 
of physical addresses a through b but labels them with dummy virtual addresses, starting 
at c. 

/HEADERS 

File: Crash-input 

Effect: Lists the contents of the task headers for each task resident in memory. 

/KERNEL:(arg[, . . . ]) 

DATA:(START:n,END:n) 

INSTRUCTION:(START:n,END:n) 

REGISTERS 

File: Crash-input 
Effect: Lists kernel data. 

/KERNEL arguments: 

DATA:(START:n,END:n) 

Effect: Lists the contents of kernel data space from virtual addresses START:n to END:n. 

INSTRUCTION:(START:n,END:n) 

Effect: Lists the contents of kernel instruction space from virtual address START:n to END:n. 

REGISTERS 

Effect: Forces the assignment of the kernel address register values for the crashed system. 

/PARTITION 

File: Crash-input 

Effect: Lists the contents of the Partition Control Blocks. 

/POOL 

File: Crash-input 

Effect: Lists the contents of system pool in octal, Radix-50, and ASCII. 

/SECONDARY_POOL:<START:n,END:n)] 
File: Crash-input 

Effect: Lists the contents of system secondary pool between the addresses specified by 
START and END. 

/[NO]SYSTEM 

File: Crash-input 

Effect: The /NOSYSTEM qualifier suppresses the system information listing. The default 
action of CDA is /SYSTEM; that is, it lists the system information. 
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/TASKS:(arg[. . . . ]) 
DIRECTORY 

ADDRESS:(NAME:name,START:n,END:n) 
DATA:(NAME:name[,START:n,END:n]) 
INSTRUCTION:(NAME:name[,START:n,END:n]) 

File: Crash-input 
Effect: Lists task data. 

DIRECTORY 

Effect: Lists the contents of the Task Control Block for every task in the System Task 

Directory (all installed tasks) at the time of the system failure. 

ADDRESS:(NAME:name,START:n,END:n) 

Effect: Lists the contents of the task specified by NAME between the virtual addresses 
specified by START and END. Includes the contents of task data space if a task includes 
data space. 

DATA:(NAME:name[.START:n,END:n]) 

Effect: Lists the contents of task data space for the task specified by NAME. 

INSTRUCTION:(NAME:name[,START:n,END:n]) 

Effect: Lists the contents of task instruction space for the task specified by NAME. 

2.2.2 ANALYZE/CRASH-DUMP Command Examples 

The foUovdng examples illustrate the ANALYZE/CRASH_DUMP command. Assume that the 
user in these examples is logged in under UIC [301,356] and that the crash dump device is 
DR5:. In this way, you can note how CD A uses default file types. Also, assume that CD A is 
runrting as an installed task. 

Example 1 

$ ANALYZE/CRASH_DUMP/LIST: CRASH/BINARY :CDPY/MEMQRYSIZE: 250 DR5: [HI] 

This command creates: 

• An output list file named CRASH.LST in the current directory for UIC [301,356]. 

• A binary copy of 250kb words of the crash dump from DR5: (the crash dump device). The 
copy is named COPY.CDA and is placed in the current directory for UIC [301,56]. 

CDA reads the binary crash dump input from the crash dump device and analyzes it according to 
the default symbol definition file. Since a symbol definition file is not specified in the command 
line, CDA uses the file named RSXllM.STB in the current UIC as the symbol definition file. 
CDA then generates a list file named CRASH.LST and spools it to the default system line 
printer queue. CDA also copies the specified amount of memory from the crash dump device 
to a binary file named COPY.CDA. 
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Example 2 

$ ANALYZE/CRASH_DUMP/LIST:LP5:/PAGE_C0UNT:5 DR5 : /BL : 100 [RETI 

This command creates a list file that is printed on LPS. 

CDA reads the crash input from DR5:, beginning at block 100, and analyzes it according to the 
default symbol definition file. CDA then prints the first five pages of its output listing on LPS. 

Example 3 

$ ANALYZE/CRASH_DUMP/LIST : TI ; /SYMBOLS : [1 , 54] COPY . CDA [RET] 



This command creates a list file that is displayed on TI (the terminal at which the command 
was issued). 

CDA reads the previously generated binary file named COPY.CDA, analyzes it according to the 
file named RSXllM.STB in directory [1,54], and displays its output listings on TI. 
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Chapter 3 
Analysis Listings 



The CDA output listings in this chapter illustrate CDA operation. Each item of each listing is 
keyed to the brief explanatory text that precedes it. 

Dumps shown in offset mode use relative addresses, rather than physical or virtual addresses, 
of the data. They are offset from the beginning of the displayed data. 

Note 

Those listings that extend across several pages in an actual dump of a crashed 
system are truncated here and reflect only a t5rpical printout. 

3.1 System Information 

The first seven pieces of a CDA output listing normally contain the system information described 
in Sections 3.1.1 through 3.1.7. This system information consists of the following: 

Volatile registers 

Kernel stack 

Low Core Memory Dump 

System common 

System common alphabetized dump 

Pool statistics 

Assign table 

If Group Global Event Flag Blocks are in memory when the system fails, the listing described in 
Section 3.1.8 appears. If error log packets are in memory at the time of the failure, the listing 
described in Section 3.1.9 appears. 
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3.1.1 Volatile Registers 

Example 3-1 is a listing that reflects the state of the hardware registers at the time of the crash. 
Refer to the appropriate PDP-11 processor handbook for detailed information on these registers. 
Each item in the following list describes a correspondingly numbered item in Example 3-1. 

O Contents of Processor Status Word (PSW) and kernel and user stack pointers after crash 

O Contents of CPU error register that identifies the source of the abort or trap that used the 
vector at location 0. This field is suppressed if the processor does not have a UNIBUS map. 

© Contents of memory system error register. This field is suppressed if the processor does not 
have a UNIBUS map. 

O Contents of cache control register. This field is suppressed if the processor does not have a 
UNIBUS map. 

© Program counter and PSW (that the system pushed onto the kernel stack) just prior to 
system crash. (These values are valid only if the system trapped.) 

© Contents of general registers. 

O Contents of memory management registers. 

© Contents of Page Address and Page Description Registers. (See Section 4.1.1 for information 
on how to interpret this information.) 

© Contents of UNIBUS map registers. (This field is suppressed if the processor does not have 
a UNIBUS map.) 
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Example 3-1: Volatile Registers 



RSX-llM-PLUS CRASH DUMP ANALYZER 
VOLATILE REGISTERS 



V4.0 25-SEP-86 15:26 
AFTER CRASH: PS=000344 SP(K) =001006 SP(S) =000422 



PAGE 1 



SP(U) =120416 O 

e e o 

CPU ERR = 000000 MEM SYS ERR = 000000 CACHE CTL REG = 000001 



BEFORE CRASH: PC=131530 PS=030000 © 

R0=022254 Rl=022200 R2=000000 R3=000000 R4=022254 R6=120553 O 

MMR0=000037 MMR1=000000 MMR2=012502 MMR3=000067 O 

UNIBUS MAP 







USER 




I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


017406 


000000 


017606 


000000 


077406 


000742 


077406 


000742 


077406 


001142 


077406 


001142 


077406 


001342 


077406 


001342 


077406 


001542 


077406 


001542 


077406 


010667 


077506 


010667 


077406 


011067 


077406 


011067 


077406 


177600 


077406 


177600 



SUPERVISOR 



I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


000402 


003117 


017406 


000000 


000000 


000000 


077406 


000742 


000000 


000000 


077406 


001142 


000000 


000000 


077406 


001342 


000000 


000000 


077406 


001542 


000000 


000000 


077406 


010114 


077402 


006160 


057406 


010314 


077402 


006360 


000002 


000000 




K E R 


N E L 




I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


077406 


000000 


177506 


000000 


077406 


000200 


077506 


000742 


077406 


000400 


077406 


001142 


077406 


000600 


077406 


001342 


077406 


001000 


077506 


001542 


077406 


010667 


077406 


010667 


077406 


011067 


077406 


011067 


077406 


177600 


077506 


177600 



1 


70200000 


2 


70210341 


3 


70210341 


4 


70210341 


5 


70210341 


6 


70210341 


7 


70210341 


8 


70210341 


9 


70210341 


10 


70210341 


11 


70210341 


12 


70210341 


13 


70210341 


14 


70210341 


15 


70210341 


16 


70210341 


17 


70210341 


18 


70210341 


19 


70210341 


20 


70210341 


21 


70210341 


22 


70210341 


23 


70210341 


24 


70210341 


25 


70210341 


26 


70210341 


27 


70210341 


28 


70210341 


29 


70210341 


30 


70210341 


31 


70210341 
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3.1.2 Kernel Stack 

Example 3-2 shows the contents of the kernel stack area beginning at V$$CTR and ending at 
$STACK. The kernel stack pointer points to a location within this area. See Section 4.1.2 for 
information on interpreting the contents of the kernel stack. 



Example 3-2: Kernel Stack 

RSX-llM-PLUS CRASH DUMP AKALYZER 
KERNEL STACK 



V4.0 25-SEP-86 15:26 
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KERNEL STACK: 

000500 047603 051120 020056 041450 020051 044504 044507 040524 

000520 020114 034461 031470 000000 000000 000000 000000 000000 

000540 000000 000000 000000 000000 000000 000000 000000 000000 

000560 000000 000000 000000 000000 000000 000000 000000 000000 

000600 000000 000000 000000 057304 013444 000000 031730 126506 

000620 030000 126454 000000 127006 013765 000076 126732 064340 

000640 003233 003233 120544 132056 000002 133542 000001 132470 

000660 120640 000000 132545 132545 134174 000003 126522 000000 

000700 132545 000001 000012 000001 000001 003233 013765 013764 

000720 125644 020540 067130 000100 120752 003764 003440 022254 

000740 027060 026022 003764 032424 000001 000002 025230 000000 

000760 010664 124270 000010 000000 046662 032324 064650 124272 

001000 120563 131530 030000 013130 022254 022200 000000 000000 

001020 022254 120553 131532 170000 

3.1.3 Low Core Memory Dump 

The listing shown in Example 3-3 contains a dump of low core memory, alphabetized by label. 
Appendix B lists labels found in low core memory and their meanings. 
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Example 3-3: Low Core Memory 



RSX-llM-PLUS CRASH DUMP ANALYZER V4. 
LOWCORE ALPHABETIZED DUMP 


25-SEP-86 16:26 
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$BCERR 000104 


123024 


SFLTGB 000000 


ISAVSP 001020 


$BCFAC 000301 


000000 


IFMAPP 000000 


$SCM0F 000742 


$BCPC 131530 


124270 


$HEADR 001050 


000003 


$CPBIT 177777 


006530 


$HFMSK 000016 


$SGFFR 000000 


$CPCRM 177777 


000000 


000000 


$SIRWF 000 


$CPUER 177766 


000000 


$ICAVL 004404 


$STAT 000000 


$CPURM 177777 


000135 


000000 


000000 


$CRDEV 000104 


000000 


IIDLCT 000 


000000 


$CRPAR 077646 


000000 


$IDLFL 000 


000000 


$CRSBF 010341 


000000 


SIDLPT 007760 


$STKDP 000000 


010341 


$DXDEP 177777 


007760 


ISTRTM 000015 


010341 


$DXDK5 177777 


$MPCTL 000001 


125460 


010341 


$DXDRL 177777 


$MSTAT 000000 


$SUPFL 000 


$CRUNT 060 


$ERLFK 021356 


000000 


$TKTCB 032300 


$CRUPC 131530 


$ERTRK 050044 


$PARLV 177777 


$UMIfflD 000000 


$CRUST 030000 


000000 


$POWSP 000000 


170200 


$CURPR 021346 


120030 


$PR0C2 377 


000034 


$CXDBL 000 


000000 


$PROCN 377 


$UMRWT 000000 


$DICSV 001051 


^000000 


$RQEHD 000742 


001102 


000037 


$FLFRK 021362 


$RqSCH 021344 




000007 


$FLSTS 000000 


$SAHDB 010664 




000037 


000000 


$SAHPT 140000 





3. 1 .4 System Common \ 

The listing in Example 3-4 provides a selective interpretation of some of the items in system 
common. Each item in the following describes the corresponding numbered item in Example 3-4. 
(Refer to the RSX-llM-PLUS and Mffro/RSX Guide to Writing an I/O Driver for further 
information.) 

O Time and date of crash, as set in the system. 

® The task that was running at the time of the crash. (If no task was running, this field 
contains the null task. This condition could develop if all the active tasks are blocked at 
the time of the crash. For information on determining which task or driver was mapped at 
the time of the crash, see Section 4.1.1.) 

® The address of the Task Control Block (TCB) of the current task. 

O The contents of the 4-byte system ID indicating system base level. 



Analysis Listings 3-5 



O The first address avaUable for partitions (the last address of the Executive plus 1). 

O The system size in 32-word blocks and in total words. 

O System UIC. 

® Stack depth count. 

O Contents of the global event flag words. 

(D Name of the system for which dump is generated. 

Network UIC. 

® Device from which the system was booted. 

® Logical block number (LBN) of the beginning of the system image. 

(D Size of system image file in blocks. 

® The octal value of the system feature masks and the meaning of each set bit. 

© Octal dump of system common in offset mode in numerical order by address. 
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Example 3-4: System Common 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 4 
SYSTEM COMMON 

CRASH OCCURRED AT 14:22:21 25-SEP-86 O 
CURRENT TASK = BRKTO TCB ADDRESS = 032300 

o e o o 

SSYSID = 27 $EXSIZ = 120000 $SYSIZ = 32768. /1024K $SYUIC = [2.54] 

o @ 

$STKDP = 000000 $COMEF: <33-48> 000000 <49-64> 100000 

SYSTEM NAME = RL02ID $NTUIC = [001,054] 

® ® ® 

LOAD DEVICE = DLO LBN = 00023367 FILE SIZE = 1024. 

SYSTEM FEATURE MASK (FIRST WORD) = 013377 

BIT SET MEANING 



EXT 22-BIT EXTENDED MEMORY SUPPORT 

MUP MULTI-USER PROTECTION SUPPORT 

EXV 20K EXEC SUPPORTED 

DRV LOADABLE DRIVER SUPPORT 

PLA PLAS SUPPORT 

CAL DYNAMIC CHECKPOINT SPACE ALLOCATION 

PKT PREALLOCATION OF I/O PACKETS 

EXP EXTEND TASK DIRECTIVE SUPPORTED 

OFF PARENT/OFFSPRING TASKING SUPPORTED 

FDT FULL DUPLEX TERMINAL DRIVER 

DYM DYNAMIC MEMORY ALLOCATION SUPPORTED 



(Continued on next page) 
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Example 3-4 (Cont.): System Common 

SYSTEM FEATURE MASK (SECOND WORD) = 167763 
BIT SET MEANING 



DAS 
LIB 
ACN 
SDW 
POL 
WND 
DPR 
IRR 
GGF 
RAS 
RBN 
SWP 
STP 



KERNEL DATA SPACE SUPPORT 

SUPERVISOR MODE LIBRARY SUPPORT 

ACCOUNTING SUPPORTED 

SHADOW RECORDING SUPPORTED 

SECONDARY POOL SUPPORTED 

SECONDARY POOL FILE WINDOWS SYSTEM 

DIRECTIVE PARTITION SYSTEM 

INSTALL, REQUEST, AND REMOVE TASK SUPPORT 

GROUP GLOBAL EVENT FLAG SUPPORT 

RECEIVE/SEND DATA PACKET SUPPORT 

ROUND ROBIN SCHEDULING SUPPORTED 

EXECUTIVE LEVEL DISK SWAPPING SUPPORTED 

EVENT FLAG MASK IS IN THE TCB 



SYSTEM FEATURE MASK (THIRD WORD) = 067364 
BIT SET MEANING 



EIS 
UDS 
PRO 
XHR 



SYSTEM REQUIRES THE EXTENDED INSTRUCTION SET 
USER DATA SPACE (M-PLUS ONLY) 
PROTO TCBS OUT OF POOL (M-PLUS ONLY) 
EXTERNAL HEADER SUPPORT (M-PLUS ONLY) 



RSX-llM-PLUS CRASH DUMP ANALYZER 
SYSTEM COMMON DUMP 



V4.0 



25-SEP-86 15:26 
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ADDR LABEL VALUE 


ADDR 


LABEL VALUE 


ADDR LABEL VALUE 




020460 113226 


020620 $FMSK4 063774 


020760 $DCCEL 001266 




113226 




000000 


$DCCEB 000000 




$ACCLK 000015 




$PRMOD 000065 


000000 




$ABTIM 125460 




$CLKHD 022430 


$DCNEL 000000 




$ACTHD 117500 




$COPT 022026 


IDCNEB 000000 




000000 




$PARHD 117734 


006731 




$COMEF 000000 




$LDRPT 117500 


$IPUCB 000000 




100000 




$TSKHD 117500 


$SCDEV 000000 




020500 $HRCPT 111454 


020640 $CBDHD 117624 


021000 $SCCTB 027476 




$DEVHD 021534 




$GGEF 023264 


$SCOFL 000400 




$TKNPT 116514 




$GFTCB 020650 


$DRAPR 002542 




$SHFPT 116310 




$GEFPT 020650 


$DRAP2 002731 




$CKCNT 177546 




000204 


$DRAP3 003117 




$CKCSR 177546 




$LDPCB 000000 


$DRAP4 003233 




$CKLDC 000000 




$VECTR 000474 


003412 




$SYUIC 001054 




$MXEXT 177777 


$DRCHE 003442 

(Continued on 


next page) 
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Example 3-4 (Cont.): System Common 



020520 000000 


020660 $AVRHD 000000 


021020 177777 


$EXSIZ 120000 


$PRIFR 000000 


$ENVEC 021014 


IPWRFL 000000 


$ULDPT 000000 


$CRKRB 115716 


$SIGFL 000000 


$GNLST 000000 


$CRSFM 000000 


000000 


$PTCBL 001776 


$CRSUN 000000 


$FXHPT 000000 


$PTCPT 001770 


$CRCSR 000000 


ILSTLK 000000 


$PASTH 000000 


$CRLCK 000001 


000003 


020674 


$RNDCT 000002 


020540 $CRAVL 023224 


020700 $NXTLK 000000 


021040 $RNDC 000006 


$K6TAB 000000 


$NXTBA 000000 


$RNDL 113001 


$VERTK 000000 


$LOGTB 001742 


$SWPCT 000010 


SLOGHD 000000 


001743 


$SWPC 000036 


$CFLPT 024020 


$USRLG 002167 


$SWPR 000005 


$MOULS 000000 


001744 


$DYPMN 020035 


$LBUIC 001454 


000000 


020037 


$NTUIC 000454 


$CTXPT 000000 


020037 


020560 000000 


020720 $PTTCB 112760 


021060 017440 


000000 


$PRISZ 056750 


017440 


$HKSTS 000000 


tPOLST 000401 


020040 


026326 


$PRIHL 003100 


000000 


026326 


$PRILL 001130 


$BTMSK 000001 


026326 


$PFRSZ 000310 


000002 


$BTTM2 000000 


$POLBP 000063 


000004 


JBTTIM 001742 


$POLFL 000000 


000010 


020600 000000 


020740 $SHUMB 000000 


021100 000020 


057252 


$SHERR 111104 


000040 


$INTCT 177777 


$SHLIM 000012 


000100 


$FRKHD 000000 


$SHPCT 000000 


000200 


020606 


$SHLOS 000000 


000400 


$FMASK 013377 


$RCTPT 112510 


001000 


$FMSK2 167763 


$EXCRC 000000 


002000 


$FMSK3 067364 


$DCPCB 000000 


004000 
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3.1.6 System Common Alphabetized Dump 

The listing in Example 3-5 represents an alphabetical list of the locations in system common 
that have a label associated with them. The octal numbers represent the contents of those 
locations, not the addresses of the labels. Appendix B lists the labels and their meanings. 



Example 3-5: System Common Alphabetized Dump 



RSX-llM-PLUS CRASH DUMP ANALYZER 
SYSTEM COMMON ALPHABETIZED DUMP 



$ABTIM 125460 
$ACCLK 000015 
$ACNFE 000050 
$ACPTK 000000 
$ACTHD 117500 
$ACTPS 000074 
$APLIM 000140 
$APRTB 172340 
SATTPT 023350 
$AVRHD 000000 
$BCMSK 001 
$BTMSK 000001 
$BTTIM 001742 
$BTTM2 000000 
$CBDHD 117624 
$CFLPT 024020 
$CKCNT 177546 
$CKCSR 177546 
$CKLDC 000000 
$CKUAB 000000 
$CKURM 177777 
$CLICq 000000 
$CLKHD 022430 
$CNTLN 000000 
$COMEF 000000 
$COPT 022026 
$CPBIT 177777 
$CPCRM 177777 



$CPMSK 177777 
$CPTBL 021464 
$CPURM 177777 
$CPUSC 177777 
$CRAVL 023224 
$CRCSR 000000 
$CRFLG 000001 
$CRKRB 115716 
$CRLCK 001 
$CRMTB 177777 
$CRSFM 000000 
$CRSUN 000000 
$CTLST 021522 
$CTXPT 000000 
$CXDBL 000 
$DCCEB 000000 
$DCCEL 001266 
$DCNEB 000000 
$DCNEL 000000 
$DCPCB 000000 
$DEVHD 021534 
$DICSV 001051 
$DRAP2 002731 
$DRAP3 003117 
$DRAP4 003233 
$DRAPR 002542 
$DRCHE 003442 
$DVSAV 000000 



V4.0 25-SEP-86 15:26 

$DYPMN 035 
$EFMSK 000007 
$ENTSQ 000001 
$ENVEC 021014 
$ERFLA 000017 
$ERHEA 000000 
$ERRPT 113420 
$ERRSq 000000 
$EVBSq 002542 
$EVDIS 002542 
$EVKS6 002542 
$EVLEN 002542 
$EVLST 002542 
$EVSEq 002542 
$EVTAB 002542 
$EXCRC 000000 
$EXECL 177777 
$EXSIZ 000 
$FLFTB 000000 
$FMASK 013377 
$FMEND 000065 
$FMSK2 167763 
$FMSK3 067364 
$FMSK4 063774 
$FRKHD 000000 
$FXRPT 000000 
$GEFPT 020650 
$GFTCB 020650 
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$GGEF 023264 
$GNLST 000000 
$HEADR 001050 
$HFMSK 000016 
$HKSTS 000000 
$HRCPT 111454 
$ICAVL 004404 
$IDLCT 000 
$IDLFL 000 
$IDLPT 007760 
$IIMSK 177777 
$INTCT 177777 
$IOTMP 077406 
$IPUCB 000000 
$K6TAB 000000 
$KATBL 016662 
$LBUIC 054 
$LDPCB 000000 
$LDRPT 117500 
$LOGHD 000000 
$LOGPT 112364 
$LOGTB 001742 
$LSTLK 000000 
$MCRPT 117124 
$MKCS1 000000 
$MKCS2 177777 
$MKCSR 177777 
$M0ULS 000000 

(Continued on next page) 
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Example 3-5 (Cont.): System Common Alphabetized Dump 



RSX-llM-PLUS CRASH DUMP ANALYZER 
SYSTEM COMMON ALPHABETIZED DUMP 



$MPTAB 177777 
$MXEXT 177777 
$NCPU 000 
$NCTPT 000000 
$NTUIC 054 
$NXTBA 000000 
$NXTLK 000000 
$PARHD 117734 
$PASTH 000000 
$PFRSZ 000310 
$PFURM 177777 
$PKAVL 023304 
$PKNUM 003 
$PKMAX 005 
$PLPAR 117734 
SPOLBP 000063 
$P0LFL 000000 
$P0LHD 002172 
$P0LST 000401 
$PRIFR 000000 
$PRIHL 003100 
SPRILL 001130 
$PRISZ 066750 
$PRMOD 000065 



$PR0C2 177777 
$PROCN 177777 
$PRTAB 000240 
$PTCBL 001776 
$PTCPT 001770 
SPTTCB 112760 
$PVWIFL 000000 
$RCTPT 112510 
$RNDC 000006 
$RHDCT 000002 
$RNDH 226 
$RNDL 001 
$ROEND 000742 
$RqSCH 021344 
tRQTAB 000000 
$SABPT 002151 
$SAHDB 010664 
$SAHPT 140000 
$SAVSP 001020 
$SCCTB 027476 
$SCDEV 000000 
$SCERR 001 
$SCMOF 000742 
$SCOFL 000 



V4.0 25-SEP-86 15:26 

$SCRET 027476 
$SECFR 000350 
$SGFFR 000000 
$SHERR 111104 
$SHFCT 000036 
$SHFPT 116310 
$SHFTM 000000 
$SHLIM 000012 
$SHLOS OOOOOO 
$SHPCT OOOOOO 
$SHUMB OOOOOO 
$SI6FL OOOOOO 
$STALR 177777 
$STENB 177777 
$STKDP OOOOOO 
$STFLG 177777 
$SWPC 000036 
$SWPCT 000010 
$SWPR 000005 
$SWR 177777 
$SYALT OOOOOO 
$SYLHD OOOOOO 
$SYSIZ 100000 
$SYUAB 002147 
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$SYUIC 054 
$TEMP0 000774 
$TEMP1 OOOOOO 
$TEMP2 026324 
$TEMP3 000003 
$TEMP4 031730 
$TKNPT 116514 
$TKPS 000074 
$TNAME 035203 
$T0NYL 002126 
$TSKHD 117500 
$TTNS 000064 
$ULDPT OOOOOO 
$UMRHD OOOOOO 
$URMST 177777 
$URMTB 177777 
$USRLG 002167 
$VECTR 000474 
$VERTK OOOOOO 
$WPLST 177777 
$WPVAL 177777 
$XDTFL 177777 
$XDTIN 177777 
$XDTPR 177777 
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3.1.6 Pool Statistics 

The listing in Example 3-6 contains information concerning the system pool. CDA derives 
Items 2, 3, and 4 by scanning the free block pointers of the pool. The minimum block size 
(that is, pool granularity) in Item 5 comes from the contents of $CRAVL-2. Each item in the 
following list describes a correspondingly numbered item in Example 3-6: 

O Pool size in decimal bytes 

© The largest fragment of pool space 

9 Total number of free bytes in pool 

O Number of fragments not allocated 

O Smallest possible block (the minimum number of bytes that may be requested at a time; 
the minimum block size is always four bytes) 

© Bit map in octal 

Each bit in the bit map represents one 4-byte block. If the bit is set, the block is free. The 
first block m the pool is bit of the first octal word in the bit map. The bits are numbered as 
follows: 



Bit Number 


15 


14 13 12 


11 10 9 


8 7 6 


5 4 3 


2 1 


Binary 





1 1 


1 1 


1 1 1 


1 1 1 





Octal 





3 


5 


7 


7 






Any bits left over in the last word of the bit map are cleared. 
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Example 3-6: Pool Statistics 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 11 
POOL STATISTICS 

POOL SIZE (BYTES) = 31156. O 

LARGEST FREE BLOCK (BYTES) = 23736. O 

TOTAL FREE BYTES = 24040. © 

B NUMBER OF FRAGMENTS =15. O 

MINIMUM BLOCK SIZE (BYTES) =4. @ 

POOL BITMAP (CONSTRUCTED FROM LINKED POOL. BLOCK FREE IF BIT SET): 

000000 020004 000000 000400 000000 140000 000000 000001 

000000 000000 014002 000000 000001 000000 000000 000000 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 037600 000174 004000 140000 001777 177770 077777 

000000 000000 000000 174000 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 © 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 

177777 177777 177777 177777 177777 177777 177777 177777 
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3.1.7 Assign Table 

Example 3-7 is a listing of the logical device assignment table. 
Example 3-7: Logical Assignment Table 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 13 
ASSIGN TABLE 

System Logicals: 

WK = LB: 

Block: 1 Status: (Final) 

User Logicals: 

Terminal: TTO: 

SyS$LOGIN = DL;[7.40] 

Block: 2 Status: (Final, Privileged) 

The Assign Table lists logical assignment table entries in two categories: system logicals and 
user logicals. The system logicals listing shows the logical name, the equivalence name, the 
logical block type, and the status of an assignment. The user logicals listing also shows the 
terminal from which an assignment was made. 

3.1.8 Group Global Event Flags 

Example 3-8 shows a group global event flag dump. If there are no group global event flags, 
this dump does not appear. 

O Group number 

O Access count 

® Group Global Event Flag Block dump (the last two words are the group global event flags) 

Example 3-8: Group Global Event Flags 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 10 
GROUP GLOBAL EVENT FLAGS 

o e 

GROUP NUMBER =7 ACCESS COUNT =000001 
GGEF DUMP: O 

000000 000000 000007 000001 000062 000000 

3.1.9 Error Log Packets 

The listing shown in Example 3-9 contains error logging information that resided in memory 
at the time of the system failure. This page does not appear if no error log packets were in 
memory at that time. This data is not written to the Error Log file on disk. 

Address of error log buffer 

O Error log packet entry type code 

Error log packet entry type subcode 
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© Time the packet was logged 

® Dump of error log packet in octal, Radix-50, arid ASCII 

Example 3-9: Error Log Packets 



IIM-PLUS CRASH DUMP ANALYZER V4 


.0 ll-MAY-87 11 


:07 
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R LOG BUFFERS 



























e 






e 


BUFFER 


ADDRESS = 


00217700 


ENTRY TYPE CODE 


= 000002 


ENTRY 


TYPE SUBC 


TIME = 


13-0CT-86 


11:16: 


03 O 












000000 


002202 


000214 


000034 


000075 


.4 CT 


. 


AU! 


! = ! 


000010 


001006 


033462 


020040 


007401 


L8 H3J 


EEX 


BPA! 


! 27 ! 


000020 


000007 


000003 


000402 


005126 


G C 


FR 


AZF! 


! V ! 


000030 


005415 


001420 


000065 


000001 


AO/ SX 


AM 


A! 


! 5 ! 


000040 


000060 


052504 


000001 


000001 


AH MY. 


A 


A! 


!0 DU ! 


000050 


052504 


000000 


000000 


000000 


MY. 




! 


!DU ! 


000060 


000000 


000000 


000000 


000000 






! 


! ! 


000070 


000000 


000000 


000001 


001440 




A 


T ! 


! ! 


000100 


000000 


000046 


000000 


000000 


8 




! 


! tc ! 


000110 


023000 


000000 


000000 


000000 


FCH 




! 


! ft ! 


000120 


000030 


070511 


100660 


003440 


X REA 


TO 


AEX! 


! IqO ! 


000130 


052124 


001000 


001000 


000007 


MS. L2 


L2 


G! 


ITT ! 


000140 


000312 


000000 


000000 


120442 


EB 




YIJ! 


!J "!! 


000150 


000002 


000046 


000040 


000001 


B 8 


2 


A! 


! k ! 


000160 


000005 


032764 


000001 


000000 


E HYL 


A 


! 


! t5 ! 


000170 


000241 


000043 


000000 


000000 


DA 5 




! 


!! # ! 


000200 


057554 


000003 


000000 


000000 


OJ. C 




! 


!1_ ! 


000210 


000000 


000000 


000263 


000000 




DS 


! 


! 3 ! 


000220 


165555 


133333 


165555 


133333 


7Z/ /JK 7Z/ /JK! 


!mk[6ink[6! 



e 



3.2 Optional Information 

CDA gives you additional information when you use the analysis switches described in Chapter 
2. Examples 3-lOa through 3-23 illustrate the output that CDA provides when you use these 
switches. 

3.2.1 Active Tasks 

The listing shown in Examples 3-lOa and 3-1 Ob contain active task information. The Receive 
Queue, AST Queue, Receive-by-Reference Queue, and Offspring Control Block sections of this 
example appear only if the task has them; otherwise, they are suppressed. 

The following list describes the active task listing given in Example 3-lOa, which includes 
Receive Queue, AST Queue, and Receive-by-Reference Queue listings: 

O Task name 

e Address of Task Control Block (TCB) for the task 

® Name of the partition in which the task runs 

O Address of Partition Control Block (PCB) 

O Base address for the partition in which the task runs 

© Device that contains task image 
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O Beginning logical block number (LBN) of the task on the device 

© Running priority 

® Number of outstanding QIO requests 

® Current UIC (either the login UIC or the UIC specified with a SET command) 

® Physical name of task's pseudo device 

® Maximum size of task image in 32 lo -word blocks 

® State of local event flags for task 

® First status word (blocking bits), using the following three-letter codes: 

-EXE Task not executing 

RDN I/O rundown in progress 

CIP Task blocked for checkpoint in progress 

MSG Abort message being output 

CKR Task has checkpoint request (RSX-llM-PLUS only) 

BLC Increment blocking count 

STP Task stopped by CLI command 
® Second status word (state bits), using the following three-letter codes: 

AST Asynchronous system trap (AST) in progress 

SIO Task stopped for buffered I/O 

DST AST recognition disabled 

AFF Task installed with affinity 

-CHK Task not checkpointable 

SEF Stopped for event flag 

REX Exit AST specified 

HLT Task being halted 

ABO Task marked for abort 

STP Task stopped 

SPN Task suspended 

WFR Task in wait-for state 
® Third status word (attribute bits), using the following three-letter codes: 

ACP Task is an Ancillary Control Processor (ACP) 

-PMD Task not dumped on s)mchronous abort 
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CMD Task is executing a CLI command 

REM Remove task on exit 

PRV Task is privileged 

MCR Task requested as an external MCR function 

SLV Task is a slave task 

CLI Task is a command line interpreter 

RST Task is restricted 

NSD Task does not allow send data 

CAL Task has checkpoint space in task image 

ROV Task has resident overlays 

NET Network protocol level 

GFL Group global event flags are locked 

SWS Reserved for Software Services 

MFC Mapping change with outstanding I/O 
® Fourth status word, using the following three-letter codes: 

MUT Task is a multiuser task 

LDD Task load device is dismounted 

PRO TCB is a prototype 

PRV Task was privileged but has cleared TB.PRV with the GIN directive 

DSP Task was built for user data space 

SNC Task uses common synchronization 
(D Octal dump of TCB in offset mode 

RECEIVE QUEUE (if the task has one) 
(D Starting address of receive block 
® Name of task 
® Octal dump of receive block in offset mode 

ASYNCHRONOUS SYSTEM TRAP (AST) QUEUE (if the task has one) 

© An item appearing in the AST queue may be one of the following: 

• Unsolicited AST 

• Floating point AST 

• Receive data AST 

• Receive-by-reference AST 
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Parity error AST 

Requested exit AST 

Power fail 

CLI command arrival AST 

Buffered I/O AST 

Offspring task AST 

Segmented buffered I/O completion AST 

Task force trace bit trap AST 

Delayed I/O completion AST 

Group-global rundown AST 

I/O request packet 

® Address of AST block 

© A 2-byte indicator (The high-order byte is an offset into the header of the AST control 
block; the low-order byte is the length of the AST control block in bytes) 

Note 

If the low-order byte is negative, the block is not an AST block, but an I/O 
request packet internal to the system. If the low-order byte is 0, the block 
is an unsolicited character AST. 

® Number of bytes allocated on task stack 

© Entry point of AST routine 

® Number of AST parameters 

® Octal dump of the AST block in offset mode (On RSX-llM-PLUS systems, two additional 
negative offset words appear in the dump) 

RECEIVE-BY-REFERENCE QUEUE (If the task has one) 

® Address of Receive-by-Reference Queue Block 

® Address of the Task Control Block (TCB) for the task that initiated the Send by Reference 

® Pointer to created attachment descriptor 

® Offset into partition as specified in window definition 

® Length to be mapped 

© The receiving task's access rights to region being mapped 

© Octal dump of Receive-by-Reference Block in offset mode 
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Example 3-1 Oa: Active Tasks with Receive Queue, AST Queue, and Receive-by- 
Reference Queue Listings 



RSX-llM-PLUS CRASH DUMP ANALYZER 
ACTIVE TASKS 

TTO O 



V4.0 



25-SEP-86 15:26 



PAGE 22 



TCB ADDRESS = 032164 



e o 

PAR = GEN PCB ADDRESS = 024254 

e o o 

LOAD ADDRESS = 00656400 LOAD DEVICE = SYO: LBN = 00006741 

PRI = 60. I/O COUNT =0. UIC = [7,40] TI = TTO: 

MAX SIZE = 000032 EVENT FLAGS = <1-16> 000000 <17-32> 000000 

AST 



T.STAT: 

T.ST2 

T.ST3 

T.ST4 

TCB DUMP: 

000000 
000020 
000040 
000060 
000100 
000120 



000000 
120001 
074005 
000002 



-PMD 
DSP 



-CHK WFR 
REM PRV 



MCR CMD GFL ® 



000000 000062 000000 100076 

024430 000000 000000 022264 

000062 006741 023102 024264 

000002 000004 000001 000001 



000000 002170 002171 023614 

020470 000000 120001 074005 

000032 020470 023216 023516 

032176 000016 000014 000000 



030764 030764 002134 000000 032262 000000 000000 002165 
000001 



RECEIVE QUEUE 

(E> ® 

RECEIVE BLOCK ADDRESS = 002170 TASK NAME = TTO 

000000 002171 000025 100076 000000 064124 071561 

000020 060563 062547 064440 020163 062542 067151 

000040 072156 073440 072151 020150 051526 040604 

000060 003440 035203 100660 

RECEIVE BLOCK ADDRESS = 002171 TASK NAME = TTO 

000000 000000 000025 100076 000000 064124 071561 

000020 060563 062547 064440 020163 062542 067151 

000040 072156 073440 072161 020150 051526 040504 

000060 003440 035203 100660 

AST QUEUE ® 



066440 071545 
020147 062563 
027044 022254 



066440 071546 
020147 062563 
027044 022254 



AST BLOCK ADDRESS = 023614 A.CBL = 001000 

SPECIFIED AST FROM; SFPA$, SRDA$, SRRA$. SPEA$, SREA$. OR SPFA$ 

(Continued on next page) 
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Example 3- 10a (Cont.): Active Tasks with Receive Queue, AST Queue, and 

Receive-by-Reference Queue Listings 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 23 

ACTIVE TASKS 

® ® ® 

A. BYT = 000016 A. AST =000610 A. NPR = 000000 

023614 024430 001000 000016 000610 000000 114600 013355 000477 ® 
023634 000000 

AST BLOCK ADDRESS = 024430 A.CBL = 001400 

SPECIFIED AST FROM: SFPA$, SRDA$. SRRA$, SPEA$. SREA$, OR SPFA$ 

A. BYT = 000016 A. AST = 000702 A. NPR = 000000 

024430 000000 001400 000016 000702 000000 000000 000000 002171 

024450 031250 

RECEIVE BY REFERENCE QUEUE 

RRQ ADDRESS = 030754 SENDER TCB = 000000 

TASK = TTO ^ 

REGION ID OF RECEIVER = 023510 OFFSET IN PARTITION = 000000 

LENGTH TO MAP = 000001 ACCESS RIGHTS = 000001 

000000 000000 000000 100076 000000 023510 000000 000001 000001 
000020 000000 000000 000000 000000 000000 000000 000000 000000 © 
000040 000001 000000 

Example 3-lOb shows an Active Tasks listing with an Offspring Control Block (OCB) list. The 
items found in this listing are described in the following list: 

O Exit event flag number of offspring task 

© Name of parent task 

© Octal dump of offspring control block in offset mode 
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Example 3- 10b: Active Tasks with OCB Listing 



RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 20 
ACTIVE TASKS 

BAPO 



TCB ADDRESS = 113544 PAR = GEN PCB ADDRESS = 031474 
LOAD ADDRESS = 01266500 LOAD DEVICE = LEO: LBN = 00032073 
PRI = 80. I/O COUNT =0. UIC = [200,200] TI = COO: 
MAX SIZE = 000473 EVENT FLAGS = <1-16> 000000 <17-32> 040000 
T.STAT: 000000 



T.ST2 
T.ST3 
T.ST4 
TCB DUMP: 



000020 STP 

052000 -PMD PRV SLV 

000000 



000000 000000 000120 000000 006270 135600 000000 113556 000000 

000020 113562 000000 040000 022026 112634 000000 000020 052000 

000040 000120 032073 023056 031474 000473 112634 024006 024006 

000060 000000 000003 000000 040000 113570 000302 000003 000000 

000100 000000 113644 000000 031074 031074 000001 024324 002147 

000120 000000 

OCB LIST: 

O 

EXIT EVENT FLAG (O.EFN) = 000000 

PARENT TASK NAME = QMG. . . O 

OCB DUMP: 

000000 000000 000000 112634 121444 000000 000000 066117 131574 O 
000020 000000 000000 000000 000010 000000 123340 

3.2.2 Task Headers 

Example 3-11 is an example of a task header listing. The following list describes its contents: 

O Task name 

® Pointer to the first word in the task header 

® Pointer to the first word in the Task Control Block (TCB) 

O Contents of Processor Status Word (PSW) and Program Counter (PC) 

Contents of the general registers 

® Initial contents of the PSW, the PC, and the stack pointer (SP) 

The task header size in decimal bytes, the number of windows required to map the task, 
and the number of logical unit numbers assigned to the task 

® Current and defauh UIC 
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© Pointer to number of window blocks 

® Pointer to header guard word 

(D Work area extension vector pointer 

® Priority difference for swapping 

® Directive Status Word 

® Address of File Control Services (FCS) impure area 

® Address of FORTRAN impure area 

© Address of overlay impure storage 

LOGICAL UNIT TABLE 

® Logical unit number (LUN) 

® Physical device name before redirect 

® Window pointer in header 

® Low-order byte of this word indicates the number of map entries active; the high-order byte 
has the following bit assignments: 

WLRDV=400 read virtual address allowed if set 

WI.WRV=1000 write virtual block allowed 

WI.EXT=2000 extend allowed if set 

WI.LCK=4000 set if locked against shared access 

WI.DLK=10000 set if deaccess lock enabled 

WI.BPS-100000 bypass access interlock if set 
® Address of File Control Block 
® File number 
® File sequence number 
® File Control Block status word 
© Number of accesses 
© Number of block locks 

WINDOW BLOCKS 
® The name of the partition in which the task runs 
® The virtual limits of the task 
® Address of attachment descriptor 
® Window size in 32-word blocks 

Offset into partition 
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® Address of the first Page Description Register (PDR) used to map the window 

® Number of PDRs used 

© The contents of the last PDR used 

© Octal dump of task header in offset mode 

Example 3-11: Task Headers (Truncated) 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 24 
TASK HEADERS 

...LDR O 



HEADER ADDRESS = 117330 TCB ADDRESS = 117500 

PS=170000 PC=120462 O 

R0=000216 Rl=012657 R2=177777 R3=032454 R4=032424 R5=032300 SP=120166 

INITIAL PS = 170017 INITIAL PC = 120230 INITIAL SP = 120166 © 

HEADER SIZE = 102. NO. OF WINDOWS =1. NO. OF LUNS = 1. O 

CURRENT UIC = [1.24] DEFAULT UIC = [1,24] © 

© © © © 

H.WND = 117432 H.GARD = 117474 H.VEXT = 000000 H.SPRI =0. 

© © © 

DSW = 000001 H.FCS = 000000 H. FORT = 000000 H.0VLY= 000000 

LOGICAL UNIT TABLE: 
©© © © ©© © ©©© 

# DEV WINDOW W.CTL W.FCB F.FNUM F.FSEQ F.STAT NAC NLCK 

1 LBO; 000000 

INSTRUCTION SPACE 

WINDOW BLOCKS: 
© © © ©©©©© 

PAR VIRT LIMITS ATT DESC WND SIZE OFFSET 1ST PDR NO. LAST PDR 

SYSPAR 120000 124277 117250 000043 000000 177612 1 021006 

HEADER: 

000000 120166 000146 000000 000000 000424 000424 170017 120230 

000020 120166 000000 000000 000000 000000 000000 000000 000000 

000040 000000 000000 117432 000001 000000 000000 000000 000000 

000060 000000 000000 000000 000000 000000 117474 000001 023056 

000100 000000 000001 117264 120000 124277 117250 000043 000000 

000120 000612 021006 170000 120462 032300 032424 032454 177777 

000140 012657 000216 000000 
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3.2.3 Command Line Interpreter Parser Block (CPB) 

The listing shown in Example 3-12 contains the Command Line Interpreter Parser Block for 
MCR. The listing corresponds to the following items: 

O Task name of the CLI 

O Starting address of the CPB 

Q C.PSTS, which is the CPB status word 

O Dump of the CPB in octal 

Example 3-12: CLI Parser Blocks 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 25-SEP-86 15:26 PAGE 124 
CLI PARSER BLOCKS 

CLI TASK NAME MCR... O 

CPB ADDRESS = 021464 CLI NAME = MCR O 

C.PSTS: LGO O 

CPB DUMP: 

000000 117124 050712 000000 000004 003404 005015 000076 005015 O 
000020 041515 037122 000000 

CLI TASK NAME ...DCL 

CPB ADDRESS = 024400 CLI NAME = DCL 

C.PSTS: POL 

CPB DUMP: 

000000 001752 014604 000000 003000 003405 005015 020044 006400 
000020 042012 046103 000076 000000 

3.2.4 Partition Information 

CDA outputs partition information in two segments. The listing shown in Example 3-13 contains 
system partition information, and the listing shown in Example 3-14 represents individual 
partition information. The following list describes elements of Example 3-13. Individual 
partitions include Attachment Descriptors and Wait Queues when they apply. 

O Partition names 

O Partition Control Block (PCB) address 

© Base address of partition in memory 

O Size of the partition 

© Type of partition 

© Task or tasks occupjdng the partition 
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Example 3-13: Partition information 

RSX-liM-PLUS CRASH DUMP ANALYZER V4.0 
PARTITION INFORMATION 



25-SEP-86 15:26 



PAGE 35 







M E M R 


Y MAP 










o 


@ 


e 


o 




o 




PARTITION 


PCB ADR 


BASE 
00000000 


SIZE 
00074200 


TYPE 


OCCUPIED E 


<EXEC> 




<POOL> 




00077314 


00074664 








SECPOL 


117734 


00174200 


00060000 


MAIN 


SECPOOL 




SYSPAR 


117670 


00254200 


00147100 


MAIN 








117624 


00254200 


00077000 


SUB 


RO COM 


IDIRllM! 




117264 


00353200 


00004300 


SUB 


TASK 


<...LDR> 




116654 


00357500 


00030600 


SUB 


TASK 


<MCR...> 




116450 


00410300 


00007700 


SUB 


TASK 


[TKTN ] 




116244 


00420200 


00003100 


SUB 


TASK 


[SHF...] 


DRVPAR 


116164 


00423300 


00071600 


MAIN 








116120 


00423300 


00006100 


SUB 


RO COM 


ITTEXT ! 




116034 


00431400 


00020500 


SUB 


RO COM 


ITTCOM ! 




115750 


00452100 


00033600 


SUB 


DRIVER 


(TT 






115144 


00505700 


00003100 


SUB 


DRIVER 


(DL 






114764 


00511000 


00000100 


SUB 


DRIVER 


(NL 






114710 


00511100 


00002500 


SUB 


DRIVER 


(VT 






114644 


00513600 


00001300 


SUB 


DRIVER 


(RD 




GEN 


114600 


00515100 


07262700 


MAIN 








114534 


00515100 


00014700 


SUB 


RO COM 


IPUCOM ! 




023640 


00532000 


00000100 


SUB 


RW COM 


■EDPREG! 






00532100 


00001700 


<HOLE> 






023524 


00534000 


00007000 


SUB 


TASK 


<PMT...> 




113354 


00543000 


00053000 


SUB 


RO COM 


+...AT.+ 




114150 


00616000 


00040000 


SUB 


RO COM 


IFCSRES! 




024254 


00656000 


00003200 


SUB 


TASK 


<TTO> 






00661200 


00004300 


<HGLE> 






023714 


00665500 


00014200 


SUB 


TASK 


<F11ACP> 




114364 


00701700 


00033000 


SUB 


RO COM 


+F11ACP+ 






00734700 


00036200 


<HOLE> 






031540 


00773100 


00013200 


SUB 


RW COM 


!XDT ! 






01006300 


00002600 


<H0LE> 






024210 


01011100 


00034300 


SUB 


TASK 


<QMG...> 




111410 


01045400 


00021000 


SUB 


RO COM 


+...MAC+ 




032424 


01066400 


00040300 


SUB 


TASK 


<BRKTO > 






01126700 


00001000 


<HOLE> 







(Continued on next page) 
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Example 3-13 (Cent.): Partition Information 



113134 


01127700 


00047000 


SUB RO COM 


+...PIP+ 


031130 


01176700 


00020300 


SUB TASK 


<SYSLOG> 




01217200 


00047000 


<HQLE> 




031474 


01266200 


00047300 


SUB TASK 


<BAP0 > 




01335500 


00052000 


<HOLE> 




032110 


01407500 


00054000 


SUB RO COM 


+...IND+ 


111630 


01463500 


00232200 


SUB RO COM 


+ . . . EDT+ 




01715700 


06046700 


<H0LE> 




031664 


07764600 


00001200 


SUB RW COM 


IDLCRSH! 


025244 


07766000 


00012000 


SUB DRIVER 


(DU:) 



Each item in the following list describes a correspondingly numbered item in Example 3-14: 

PARTITION CONTROL BLOCK 
O Partition name 

® Pointer to the first word of the PCB 
O Type of partition 
O Name of main partition 

© Physical base address of partition in 32-word blocks 
© Partition size in 32-word blocks 
O Pointer to the first word of the TCB of attached task 
© Partition protection word (mapped system only) 
© Priority of attached task or partition 
(E> Resident mapped task count 
© Size of external header in 64-byte blocks 
® I/O count of attached partition 
® Partition status flags, using the following three-letter codes: 

OUT Partition is out of memory 

CKP Partition checkpoint in progress 

CKR Partition checkpoint is requested 

CAP Checkpoint space allocation faUure 

-CHK Partition is not checkpointable 

FXD Partition is fixed 

LFR Last head of region failure 

PER Parity error in partition 

LIO Marked by Shuffler for long I/O 
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NSF Partition cannot be shuffled 

COM Library or common block 

DEL Partition should be deleted when not attached 

® Octal dump of PCB in offset mode 

PARTITION WAIT QUEUE 

® Any partition with the heading WAIT QUEUE: and P.STAT containing the code OUT is 
awaiting access to the previous partition 

ATTACHMENT DESCRIPTOR 
® Address of attachment descriptor 
® Partition to which attachment occurs 
® Name of attaching task 
® PCB attachment queue thread word 
® TCB attachment queue thread word 
® Priority of highest priority task attached to this partition 
® I/O count of attached partition 

® Number of times task is mapped through this attachment descriptor 
© Attachment descriptor status byte, using the following three-letter codes: 

DEL Task has delete access 

EXT Task has extend access 

WRT Task has write access 

RED Task has read access 

PRO TCB is secondary pool TCB bias 

SPB Cache bypass request 

RBP Request to not bypass cache 

® Octal dump of attachment descriptors in offset mode 
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Example 3-14: Partition Control Blocks and Attachment Descriptors 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 lO-OCT-86 13:32 PAGE 30 
PARTITION INFORMATION 

NAME PCB ADR TYPE MAIN BASE SIZE P. OWN PRO PRI RMCT HDLN PIOC 

DLCRSH 032424 SUB GEN 077706 000012 000000 000000 0. 0. 0. 0. 

P.STAT: 014600 -CHK FXD -NSF COM ® 

P.ST2: 000000 

000000 000000 000000 015343 071600 000000 114600 077706 000012 
000020 000000 000000 000000 000000 014600 000000 000000 000000 ® 
000040 032462 000000 



NAME PCB ADR TYPE MAIN BASE SIZE P. OWN PRO PRI RMCT HDLN PIOC 

CROWD 025244 MAIN CROWD 077720 000060 000000 000000 0. 0. 0. 0. 

P.STAT: 000000 

P.ST2: 000000 

000000 000000 000000 012637 110140 031020 025244 077720 000060 
000020 031744 031744 000000 000000 000000 000000 000000 000000 
000040 025302 000000 

WAIT QUEUE: <E> 

NAME PCB ADR TYPE MAIN BASE SIZE P. OWN PRO PRI RMCT HDLN PIOC 

EDPTO 031744 SUB CROWD 000000 000033 032170 000000 60. 0. 3. 0. 

P.STAT: 110010 OUT -CHK DEL 

000000 000000 000074 012637 110140 000000 025244 000000 000033 
000020 000000 000033 000000 032170 110010 000000 000000 000000 
000040 032002 000003 

NAME PCB ADR TYPE MAIN BASE SIZE P. OWN PRO PRI RMCT HDLN PIOC 

lOETO 031020 SUB CROWD 077720 000033 031554 000000 60. 0. 3. 148. 

P.STAT: 010010 -CHK DEL 

000000 000000 000074 012637 110140 000000 025244 077720 000033 
000020 000000 000033 000000 031554 010010 000000 000000 023334 
000040 023334 112003 

ATTACHMENT DESCRIPTORS: 

ADDRESS PARTITION ATT TASK A.PCBL A.TCBL PRI IOC MAP COUNT 

023334 CROWD lOETO 000000 000000 60. 148. 1. 

A.STAT: WRT RED © 

000000 000000 112074 031554 000000 000403 031020 ® 
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3.2.5 Common Block Directory 

CDA lists partition information, status words, and Partition Control Blocks for each installed, 
named common region. The listing in Example 3-14 shows a Common Block Directory entry. 
The following list describes the items in Example 3-14: 

O Name of the installed common region partition 

© Address of Partition Control Block (PCB) 

® Type of partition 

© Name of the main partition 

© Physical base address of partition 

© Size of partition in 32-word blocks 

O Owning UlC of the common region 

© Partition protection word 

© Priority of attached task or partition 

© Resident mapped task count 

® Size of external header, in 64-byte blocks 

® I/O count of attached partition 

® Partition status words, using the following three-letter codes: 

OUT Partition is out of memory 

CKP Partition checkpoint is in progress 

CKR Partition checkpoint is requested 

CAP Checkpoint space allocation failure 

-CHK Partition is not checkpointable 

FXD Partition is fixed 

LFR Last head of region failure 

PER Parity error in partition 

LIO Marked by Shuffler for long I/O 

NSF Partition cannot be shuffled 

COM Library or common block 

DEL Partition should be deleted when not attached 

® Octal dump of PCB 

® Address of PCB of the common task image file 

© Address of Unit Control Block (UCB) of the device on which the common resides 
® Starting logical block number (LBN) of the common task image file 
® Word that always contains a 
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Example 3-14: Common Block Directory 

RSX-llM-PLUS CRASH DUMl 
COMMON BLOCK DIRECTORY 

o e 

NAME PCB ADR 

PUCOM 114534 
P.STAT: 014600 

P.ST2: 040106 LMA RON APR 

000000 000000 001000 063513 057710 023640 114600 005151 000147 
000020 114064 000147 114514 000424 014600 040106 021042 000000 
000040 114572 000000 

COMMON TASK IMAGE FILE PCB 

PCB ADR P.UCB P. LBN P.REL 



•UMP ANALYZER V4.0 


26-SEP-86 15:26 


PAGE 53 


IRY 

@ o ® 

TYPE MAIN BASE 
SUB GEN 005151 


e o ® 

SIZE P. OWN PRO 
000147 000424 021042 


PRI RMCT HDLN PIOC 
0. 2. 0. 0. 


-CHK fXU -NSF COM 







114514 023056 000000,026037 000000 

3.2.6 Device Information 

CDA lists information on all devices known to the system. The listing in Example 3-16 shows 
a disk device listing with an I/O packet. Items 14, 15, 16, and 17, the Terminal Status Words, 
appear only in listings for terminal devices. The codes for these items apply only to the full- 
duplex terminal driver. The section labeled I/O REQUEST PACKETS appears only for devices 
that have an I/O request in progress or an I/O request queued at the time of the system crash. 
The following list describes the items in Example 3-16: 

O Device name 

© Address of offset in Unit Control Block (UCB) 

e Address of offset in Device Control Block (DCB) 

O Address of offset in Status Control Block (SCB) 

Device to which unit is redirected 

© Name of Ancillary Control Processor (ACP) 

© Name of attached task 

© Pointer to the UCB name of the owning terminal 

© UIC used to log into the system 

© Unit status byte, using the following three-letter codes: 

BSY Unit is busy 

-MNT Unit is not mounted 
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FOR Unit is mounted as a foreign volume 

MDM Unit is marked for dismount 

PWF Power fail occurred 

WCK Write check enabled 

SPU Unit is spinning up 

W Volume is valid 
© Unit status extension byte, using the following three-letter codes: 

OFL Unit off line 

-RED Unit is not redirectable 

PUB Unit is public device 

UMD Unit attached for diagnostics 

PDF Privileged diagnostic functions only 
® Control Processing flags, using the following three-letter codes: 

-ALG Byte alignment not allowed 

NPR Device is a NPR device 

QUE Call driver before queuing 

PWF Always call driver at power fail entry point 

ATT Call driver on attach/detach 

KIL Always call driver at 1/0 kill 
® First device characteristics word, using the following three-letter codes: 

REC Record-oriented device 

CCL Carriage-control device 

TTY Terminal device 

DIR File-structured device 

SDI Single directory device 

SQD Sequential device 

MSD Mass storage device 

EXT Unit on extended 22-bit UNIBUS controller 

UMD User-mode diagnostics supported 

MBC MASSBUS device 

SWL Unit software write locked 
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ISP Input spooled device 

OSP Output spooled device 

PSE Pseudo device 

COM Device is mountable as COM channel 

Fll Device is mountable as Files-11 device 

MNT Device is mountable 

© With heading of U.CW2: second device characteristics word, using the following three-letter 
codes: 

DHl Unit is a multiplexer 

DJl UnitisaDJll 

RMT Unit is remote 

HFF Unit handles hardware form feeds 

NEC Solicited input not echoed 

CRT Unit is a CRT 

ESC Unit generates escape sequences 

-LOG User not logged in on terminal 

SLV Unit is a slave terminal 

DZl Unit is a DZll 

HLD Terminal is in hold screen mode 

AT. MCR command AT. is being processed 

PRV Unit is a privileged terminal 

L3S Unit is an LA30S terminal 

VT5 Unit is a VT05B terminal 

LWC Lowercase to uppercase conversion 

® With heading of U.TSTA: terminal status word, using the following three-letter codes: 

RST Read with special terminators in progress 

RUB Rubout sequence (non-CRT) in progress 

ESC Escape sequence in progress 

RAL Read pass all in progress 

RNE Echo suppressed 

CTO Output disabled 

OBY Output busy 
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IBY Input busy 

BEL Bell pending 

DPR Defer processing of character in buffer 

DEC Defer echo of character in buffer 

DSI Input processing disabled 

CTS Output stopped by CTRL-S 

USI Unsolicited input in progress 

OBF Buffered output in progress 

IBF Buffered input in progress 

© With heading of U.TSTA+2: second terminal status word, using the following three-letter 
codes: 

ACR Wrap-around required 

CR Trailing carriage return required on output 

BRQ Break-through write is queued 

WRA Control for wraparound 

SRQ Special request is queued 

WRB Low bit in 52-WRA bit pattern 

ORQ Output request is queued 

IRQ Input request is queued 

HFL Horizontal fill required 

VFL Vertical fill required 

HHT Hardware horizontal tab is present 

HFF Hardware form-feed is present 

FLF Force line feed before next echo 

FDX Line is full duplex mode 

® With heading of U.TSTA+4: fourth terminal status word, using the following three-letter 
codes: 

RAL Terminal is in read-pass-all mode 

WES Task waiting for escape sequence 

RPO Read with prompt output in progress 

TAB Type-ahead buffer allocation requested 

SBC Pass eight bits on input 
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ABD Autobaud speed detection enabled 

RCU Restore cursor 

ABP Autobaud speed detection in progress 

WAL Terminal is in write-pass-all mode 

VER Last character in t5^e-ahead buffer has a parity error 

BCC Last character in type-ahead buffer has a framing error 

DAO Last character in type-ahead buffer has a data overrun error 

PCU Position cursor 

UNIT CONTROL BLOCK 

© Octal dump of Unit Control Block (UCB), including negative offsets 
® Octal dump of UCB extension if a UCB extension is present 

DEVICE CONTROL BLOCK 

® Octal dump of Device Control Block 

STATUS CONTROL BLOCK 
® Octal dump of Status Control Block 

I/O REQUEST PACKETS 
® Address of the first word of the I/O packet 
® Name of the task requesting 1/0 
© Priority of the task requesting I/O 
© Event flag number used to signal I/O completion 
© Logical unit number used by requesting task 

Note 

If the task was checkpointed while the packet was queued, this number 
may not be correct. If the address in I.LN2 is within the task header, the 
logical unit number is correct. 

© I/O function codes (for detailed information on the legal I/O function codes for each device, 
refer to the RSX-UM-PIUS and Micro/RSX I/O Drivers Reference Manual) 

© Status of the I/O request - current or queued 

© Octal dump of I/O request packet in offset mode 

© I.LN2 - pointer to the second word of the LUN 
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Example 3-16: Device Information and I/O Packet (Truncated) 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 lO-OCT-86 13:32 PAGE 47 
DEVICE INFORMATION ) 

DUO: O 



o 


e 


o 





UCB ADR 


DCB ADR 


SCB ADR 


REDIRECT 






. — 




024602 


024542 


025140 




U.STS: 


BSY FOR 


VV ® 




U.ST2: 









U.CTL: 


-ALG NPR 


PWF LGH 


(D 


U.CWl: 


MNT Fll 


UMD MSD 


DIR ® 


<D 








® 









ACP 



o 

ATT 



® 

OWNER 

NONE 



LOGIN UIC 



UNIT CONTROL BLOCK: © 

024572 000000 000377 031700 000000 024542 024602 120721 000000 

024612 140710 000000 166100 001000 025140 000000 000000 000000 

024632 000000 002137 000000 024334 000000 000000 000000 000200 

024652 000000 024652 002136 000000 

UNIT CONTROL BLOCK EXTENSION: ® 

000000 000000 000000 000000 000000 000000 000000 000000 000000 

000020 000000 070503 144000 003336 000000 002410 000000 157000 

000040 000006 000000 000000 000000 005000 000000 000000 000000 

000060 000000 000000 000000 000000 000000 000000 

DEVICE CONTROL BLOCK: ® 

024542 022750 024602 052504 001400 000060 120314 177477 000070 

024562 000000 177200 000377 000000 000000 000377 031700 

STATUS CONTROL BLOCK: ® 

025140 042150 072210 000000 000000 025022 025140 013355 042100 

025160 074170 000000 000204 025130 000064 000000 063513 005151 



I/O REQUEST PACKETS: 



PACKET ADR 
042150 



REQUESTOR 
lOETO 



PRI 
60. 



EFN 
1. 



LUN 
1. 



FUNCTION CODE 
lO.RLB 



STATUS 
QUEUED 



000000 033250 000474 031554 140100 024602 001000 000000 000000 
000020 000000 000000 017400 173554 001000 000000 000000 000263 
000040 000000 000000 023334 000000 
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3.2.7 System Task Directory 

CDA scans the System Task Directory and outputs the information contained in Example 3-17. 
The information in this format is identical to the first 17 items described in Example 3-lOa of 
this manual. 



Example 3-17: System Task Directory (Truncated) 



RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 
SYSTEM TASK DIRECTORY (PRIMARY POOL) 

. . .LDR 



26-SEP-86 13:51 



PAGE 1 



TCB ADDRESS = 117S00 PAR = SYSPAR PCB ADDRESS = 117264 
LOAD ADDRESS = 00353200 LOAD DEVICE = LBO: LBN = 00000000 
PRI = 248. I/O COUNT =0. UIC = [1.24] 
MAX SIZE = 000043 EVENT FUGS = <1-16> 000001 
T.STAT: 000000 



TI = COO: 
<17-32> 000000 



T.ST2: 


020020 -CHK STP 














T.ST3: 


050200 -PMD PRV 


NSD 












T.ST4: 


000000 
















TCB DUMP: 


















000000 


000000 


000370 


000000 


131574 


045662 


000000 


117512 


000000 


000020 


117516 


000001 


000000 


022026 


116514 


000000 


020020 


050200 


000040 


000370 


000000 


023056 


117264 


000043 


117124 


117256 


117256 


000060 


000000 


000000 


000000 


000001 


117522 


000043 


000000 


000000 


000100 


000000 


117600 


000000 


000000 


117606 


000000 


000000 


002147 


000120 


000000 

















3.2.8 Pool Dump 

As shown in Example 3-18, CDA prints the system pool in octal, Radix-50, and ASCII. On 
RSX-llM-PLUS systems with secondary pool support, CDA prints a dump of the secondary 
pool with the /SECPOL switch. If a line is repeated more than nine times, CDA prints it once 
and then prints a message indicating the number of identical lines. 

The symbols in Example 3-18 have the following meanings: 

* Indicates that the next word is allocated. 

+ Indicates that the next word is contained in an unused, preallocated I/O packet (in $PKAVL 
free list). 

Note 

$PKAVL is a list containing fixed-size blocks. The blocks in this list 
are used for fast allocation, and I.LGTH determines the length of 
these blocks. 

Indicates that the next word is allocated in both $CRAVL and $PKAVL. (This is an error 
condition.) $CRAVL is the free pool list head. 
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Example 3-18: Pool Dump (Truncated) 

RSX-llM-PLUS CRASH DIM> ANALYZER V4.0 25-SEP-86 
POOL DUMP 



15:26 



PAGE 84 



SYSTEM 



POOL 



* = NEXT WORD ALLOCATED FIRST FREE BLOCK ($CRAVL) = 023224 
+ = NEXT WORD IS IN $PKAVL LIST $PKAVL = 023304 

- = NEXT WORD IS IN $PKAVL AND ALSO IN $CRAVL 



023114 


+ 031024 + 000050 + 000020 + 000000 


!H T 


A P 


! 


! 2( 




023124 


+ 115272 + 001010 + 123024 + 010717 


!XOJ 


M ZV6 


B39! 


!: 


ftO 


023134 


+ 140024 + 000000 + 002000 + 073170 


!0/L 


YX 


R8H! 


! (9 


XV 


023144 


+ 001564 + 000001 + 001564 + 001564 


! VD 


A VD 


VD! 


!t t 


t 


023154 


+ 000001 + 000000 + 000000 + 000000 


! A 




! 


! 




023164 


* 024454 * 000000 * 112634 * 127644 


!FWT 


W7T 


.DD! 


!,) 


$/ 


023174 


* 000000 * 121452 * 000000 * 000000 


1 


ZDJ 


! 


! *# 




023204 


* 000016 * 000646 * 000000 * 000062 


N 


JV 


AJ! 


! ft 


2 


023214 


* 032154 * 023446 * 000403 * 024254 


HOT FJV FS 


FTL! 


!14fe' 


.( 


023224 


023300 000004 * 000402 * 032110 


FH 


D FR 


HNX! 


!«& 


H4 


023234 


* 114150 * 000000 * 023414 * 001000 


XOP 


FI6 


L2! 


!h 


1 


023244 


* 112760 * 131162 * 000000 * 125230 


W9X 


.VB 


$K2! 


!p r2 


* 


023254 


* 000002 * 113002 * 000000 * 000560 


B 


X B 


IH! 


! 


p 


023264 


* 000000 * 000007 * 000001 * 000062 




G A 


AJ! 


! 


2 


023274 


* 000000 * 000000 023454 000004 




FJ. 


D! 


! 


1 


023304 


+ 023114 + 000050 + 000020 + 000000 


FED 


A P 


! 


!Lft( 




023314 


+ 115272 + 001010 + 123024 + 010717 


XOJ 


M ZV6 


B39! 


! : 


kO 


023324 


+ 140024 + 000000 + 002000 + 073170 


0/L 


YX 


R8H! 


! Q 


XV 


023334 


+ 006530 + 000001 + 006530 + 000000 


BEP 


A BEP 


! 


!X X 




023344 


+ 000000 + 000000 + 000000 + 000000 






! 


! 




023354 


* 000000 * 000224 * 112760 * 000000 




C. W9X 


! 


' P 




023364 


* 000403 * 023524 * 000000 * 002400 


FS 


FK. 


2 ! 


1 f 1 




023374 


* 000022 * 124260 * 000002 * 000144 


R 


Z9X B 


BT! 


! 0( 


d 


023404 


* 000000 * 073376 * 100660 * 000000 




SAV TO 


! 


! -vO 




023414 


* 023570 * 000000 * 112364 * 145201 


FLX 


W3L 


2PAI 


!x' t 


J 


023424 


* 000000 * 124402 * 000000 * 000000 




$AZ 


! 


! ) 




023434 


* 000000 * 000477 * 023510 * 000062 




G9 FKP 


AJ! 


! ? H 


•2 


023444 


* 032154 * 023516 * 000401 * 023640 


HOT 


FKV FQ 


FMX! 


!14N' 


' 


023454 


023704 000004 * 000000 * 000113 


FNT 


D 


A5! 


!D' 


K 


023464 


* 112634 * 023502 * 000403 * 024210 


W7T 


FKJ FS 


FSPI 


! B' 


( 


023474 


* 000000 * 000113 * 112634 * 000000 




A5 W7T 


! 


! K 


! 


023504 


* 000401 * 114150 * 000000 * 000062 


FQ XOP 


AJ! 


! h 


2 ! 


023514 


* 032154 * 000000 * 000001 * 023640 


HOT 


A 


FMX! 


!14 


•! 


023524 


* 113354 * 000224 * 026226 * 000000 


XE6 


C. GEN 


I 


!1 




023534 


* 113354 * 114600 * 005340 * 000070 


XE6 XVP A/X 


AP! 


!1 


'a ! 


023544 


* 000000 * 000070 * 000000 * 112760 ! 




AP 


W9X! 


! 8 


P ! 


023554 


* 000010 * 000000 * 000000 * 023354 ! 


H 




FID! 


! 


1ft! 


023564 


* 023354 * 000002 * 000000 * 000000 ! 


FID 


B 


! 


!lft 


! 


023574 


* 112364 * 104641 * 000003 * 124504 ! 


W3L 


V 3 C $CL! 


!t ! 


D)! 


023604 


* 000000 * 000000 * 023400 * 177776 ! 




FIX 


8NI 


! 


- 1 


023614 


* 024430 * 001000 * 000016 * 000610 ! 


FW 


L2 N 


12! 


! ) 


! 


023624 


* 000000 * 114600 * 013355 * 000477 ! 




XVP cz/ 


G9! 


! m 


? ! 


023634 


* 000000 * 000477 * 000000 * 000463 ! 




G9 


G$! 


! ? 


3 ! 


023644 


* 017760 * 070517 * 023524 * 114600 ! 


EDP REG FK. 


XVP! 


!p OqT 


! 


023654 


* 005320 * 000001 * 114150 * 000001 ! 


A/H 


A XOP 


A! 


!P h 


! 


023664 


* 000000 * 003440 * 000210 * 000200 ! 




AEX OP 


CH! 




j 



(Continued on next page) 
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Example 3-18 (Cont.): Pool Dump (Truncated) 



RSX-llM-PLUS CRASH DUMP ANALYZER 
SECONDARY POOL DUMP 



V4.0 



25-SEP-86 15:26 



PAGE 101 



SECONDARY POOL 



NUMBER OF FREE BYTES = 00035000 



FIRST FREE BYTE = 00217200 



LENGTH = 00060000 BYTES 



START ADDRESS = 00174200 



ENDING ADDRESS = 00254177 



00174200 


000000 


000000 


000000 


000000 










! ! 


00174210 


000000 


000000 


000000 


000000 










! ! 


00174220 


000000 


000000 


000000 


000000 










! ! 


00174230 


000000 


000000 


000000 


000000 










! ! 


00174240 


000000 


000000 


000000 


000000 








!! ! 


00174250 


000000 


000000 


000000 


000000 










! I 


00174260 


000000 


000000 


001745 


000000 






X7 




! e I 


00174270 


000000 


000000 


000000 


000000 










! ! 






[ABOVE LINE REPEATED 16. TIMES] 










00174500 


000000 


000400 


000001 


000000 




FP 


A 


!! ! 


00174510 


001402 


045527 


041114 


000072 


SJ 


LBG 


JXL 


AR! 


1 WKLB: ! 


00174520 


000000 


000000 


000000 


000000 










! ! 


00174530 


000000 


000000 


000000 


000000 










1 ! 


00174540 


000000 


000000 


000000 


000000 










! ! 


00174550 


000000 


000000 


000000 


000000 










! 1 


00174560 


000000 


000000 


000000 


000000 










j ! 


00174570 


000000 


000000 


000000 


000000 










! ! 


00174600 


000000 


000101 


113670 


131574 




AY 


XK 




! A 8 13! 


00174610 


003273 


000000 


140012 


000000 


ACC 




0/B 




!; Q ! 


00174620 


140016 


000000 


000000 


000000 


0/F 








! « ! 


00174630 


002030 


100000 


020000 


050000 


ZH 


TSH 


ED2 L2 ! 


1 P! 


00174640 


000101 


030660 


023056 


114600 


AY 


G8 


FDN 


XVP! 


!A 01. t; ! 


00174650 


000311 


000000 


000000 


140054 


EA 






0/6! 


!I ,«! 


00174660 


000010 


000003 


000000 


000000 


H 


C 






! ! 


00174670 


000000 


000120 


000003 


000000 




B 


C 




! P ! 


00174700 


000000 


140100 


000000 


000000 




OOP 






! m ! 


00174710 


140106 


000000 


000000 


000000 


OOV 








IFfi ! 


00174720 


000000 


000000 


000000 


000000 










! ! 


00174730 


000000 


000000 


000000 


000000 










! ! 


00174740 


000000 


000000 


000000 


000000 










! ! 


00174750 


000000 


000000 


000000 


000000 










! ! 


00174760 


000000 


000000 


000000 


000000 










! ! 


00174770 


000000 


000000 


000000 


000000 










! ! 


00175000 


000000 


000062 


000000 


131574 




AJ 






! 2 13! 


00175010 


007537 


000000 


140012 


000000 


BRO 




0/B 




!_ (D ! 


00175020 


140016 


000000 


000000 


000000 


!0/F 








! e ! 


00175030 


001756 


100000 


020000 


050000 


! YF 


TSH 


ED2 


L2 ! 


!n P! 


00175040 


000062 


026527 


023056 


114600 


! AJ 


GJG 


FDN 


XVP! 


!2 W-.& ! 


00175050 


000363 


000000 


000000 


140054 


! FC 






0/6! 


Is ,«! 


00175060 


000010 


000003 


000000 


000000 


! H 


C 






I 1 


00175070 


000000 


000360 


000003 


000000 


! 


F 


C 




! p 1 


00175100 


000000 


140100 


000000 


000000 


! 


OOP 






! m 1 
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3.2.9 Task Dump 

CDA prints all or a portion of the task's virtual address space if the /TASK switch is specified. 
Example 3-19 and the following list illustrate this output. 

O Task name 

© Address of the first word of the Task Control Block for the task 

O Address of the first word of the task's header 

WINDOW BLOCKS 

O Name of the partition to which the task is mapped 

Task virtual address limits 

© Address of the attachment descriptor 

© Size of window in 32-word blocks 

© Offset to memory region within partition in 32-word blocks 

© First Page Description Register (PDR) used to map the task 

® Number of PDRs used to map task 

© Contents of the last PDR used to map the task 

© Task virtual address limits 

® Physical starting address of the memory region being dumped 

© Dump of the data within the window, formatted in octal, Radix-50, and ASCII 
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Example 3-19: Task Dump (Truncated) 



RSX-llM-PLUS CKASH DUMP ANALYZER 
TASK DUMP 



V4.0 



26-SEP-86 13:50 



PAGE 1 



TASK DUMP OF TTO O 



INSTRUCTION SPACE 



TC6 ADDRESS = 032154 



HEADER ADDRESS = 006560 



WINDOW BLOCKS: 
PAR VIRT LIMITS ATT DESC WND SIZE OFFSET 1ST PDR NO. LAST PDR 



GEN 



000000 000777 023210 000010 000004 177600 



003406 



WINDOW #1 ~ TASK VIRTUAL LIMITS 000000-000777 ® 



PHYSICAL STARTING ADDRESS = 00656400 ® 



000000 


000000 


000232 


140315 


160400 ! 


C4 


037 6 


000010 


003440 


003440 


174017 


000314 " 


AEX AEX 9$W ED 


000020 


001314 


oooooo 


oooooo 


oooooo " 


Q6 




000030 


000000 


oooooo 


oooooo 


oooooo 






000040 


000000 


140232 


000126 


oooooo 


02Z 


BF 


000050 


000000 


oooooo 


oooooo 


oooooo 






000060 


000000 


oooooo 


oooooo 


oooooo 






000070 


000000 


000230 


000006 


oooooo 


C2 


F 


000100 


000000 


OOOOOO 


oooooo 


oooooo 






000110 


000000 


oooooo 


oooooo 


oooooo 






000120 


000000 


oooooo 


oooooo 


000003 




c 


000130 


000000 


oooooo 


oooooo 


oooooo 






000140 


000000 


oooooo 


oooooo 


oooooo 






000150 


000000 


oooooo 


oooooo 


oooooo 






000160 


000000 


oooooo 


oooooo 


oooooo 






000170 


000000 


oooooo 


oooooo 


oooooo 






000200 


000000 


oooooo 


oooooo 


oooooo 






000210 


000000 


oooooo 


000002 


160400 




B 6 


000220 


140315 


oooooo 


oooooo 


oooooo 


037 




000230 


000000 


oooooo 


oooooo 


oooooo 






000240 


000000 


oooooo 


oooooo 


oooooo 






000250 


000000 


oooooo 


oooooo 


oooooo 






000260 


oooooo 


oooooo 


oooooo 


oooooo 






000270 


oooooo 


oooooo 


oooooo 


oooooo 






000300 


oooooo 


oooooo 


oooooo 


oooooo 







M a 

xL 



OV 



m 



<D 
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3.2.10 Clock Queue 

The example in Example 3-20 shows a clock queue listing. The following list explains the 
example: 

O Address of the clock queue entry 

© One of the following types of time schedule requests: 

Type Mark time request 

Type 2 Request with periodic rescheduling 

Type 4 Single-shot task request 

Type 6 Single-shot internal system subroutine with system subroutine identification 

Type 10 Single-shot internal system subroutine without system subroutine identification 

Type 12 Clear stop bit (Shuffler) 
® Task Control Block address or system subroutine identification 
© Task issuing the clock request 

© The hour, minute, and second that time request comes due 
© This field varies with each type of time schedule request 

For a mark time request, the labels are: 

CAST AST address 

C.SRC Event flag mask word 

C.DST Event flag mask address 
Event Flag Number 

For a periodic rescheduling request, the labels are: 

C.RSI Reschedule internal 

C.UIC Scheduling UIC 

The field for a single-shot task request contains only one label: 

C.UIC Scheduling UIC 

The field for a single-shot internal subroutine (both Avith and without system subroutine 
identification) contains: 

C.SUB Subroutine address 

CARS Relocation base address (for loadable drivers) 

© Octal dump of clock queue in offset mode 
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25-SEP-86 15 


:26 


PAGE 76 




e 




o 


TCB 


= 112634 


TASK 


= QMG. . . 


e 








)ST = 


000000 


EVENT 


FLAG = 0. 



Example 3-20: Clock Queue 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 
CLOCK QUEUE 

o e 

ADDRESS = 023164 REQUEST TYPE = 

TIME REQUEST BECOMES DUE = 14:22:40.8 

CAST = 121452 C.SRC = 000000 C. 

000000 024454 000000 112634 127644 000000 121452 000000 000000 © 
000020 000016 

ADDRESS = 024454 REQUEST TYPE =0 TCB = 032154 TASK = TTO 

TIME REQUEST BECOMES DUE = 14:22:43.5 

CAST = 000000 C.SRC = 000001 CDST = 032176 EVENT FLAG = 1. 

000000 023240 000400 032154 130105 000000 000000 000001 032176 
000020 122526 

ADDRESS = 023240 REQUEST TYPE = TCB = 112760 TASK = PMT. . . 

TIME REQUEST BECOMES DUE = 14:22:52.8 

CAST = 125230 C.SRC = 000002 CDST = 113002 EVENT FUG = 2. 

000000 023414 001000 112760 131162 000000 125230 000002 113002 
000020 000000 

3.2. 1 1 Controller Information 

Example 3-21 shows the information associated with a device controller. The following list 
explains the items in Example 3-21: 

. O Name of the device controller 

O Address of the Controller Table (CTB) 

O Address of the Device Controller Block (DCB) for this device 

O CTB status byte, which may contain any of the following three-letter status codes: 

CLK Clock block appears at the top of the CTB 

MDC Multidriver CTB 

CBL Clock block is linked into the clock queue 

CIN Controller uses the common interrupt dispatch table 

NET DECnet device 

Octal dump of the CTB 
© Common Interrupt Address 

DCB for each device interfaced by this controller 
© Name of each device interfaced by this controller 
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© Address of the Controller Request Block (KRB) 

(D Controller status; the following is a list of possible status values and their meanings: 

OFL Controller is off line 

MOF Controller is marked for off line 

UOP Controller supports overlapped operations 

MBC Device is a MASSBUS controller 

SDX Seek operations allowed during data transfers 

POE Parallel operations enabled 

UCB UCB table present 

DIP Data transfer in progress 

PDF Privileged diagnostic functions only 

® Octal dump of KRB in one or two parts 

Example 3-2 1 : Controller Information 

RSX-llM-PLUS CRASH DUMP ANALYZER V4.0 lO-OCT-86 14:22 PAGE 1 
CONTROLLER INFORMATION 

RH O 

CTB ADDRESS = 022216 L.DCB = 022274 

L.STS: MDC CIN O 

CONTROLLER TABLE BLOCK: 

022214 000000 022316 044122 022274 005020 000000 110404 114474 
022234 106614 000000 110460 114554 105664 000000 110532 114636 O 
022264 107202 000000 110614 114722 105734 

DEVICES INTERFACED BY THIS CONTROLLER: 

COMMON INTERRUPT ADDRESS = 023300 © 

o ® 

DCB DEVICE NAME 



113270 


DB 


107314 


DR 


107030 


EM 


104574 


MM 



KRB ADDRESS = 110404 ® 
K.STS: SDX UOP MBC POE UCB (D 

CONTROLLER REQUEST BLOCK: 

110366 000000 110532 110614 000000 015240 000002 000174 176300 
110406 000034 000003 000000 000000 110414 000001 000000 000000 
110426 000000 000000 000000 000000 

110424 000000 000000 000000 000000 000000 000050 000000 000000 
110444 000000 107544 
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3.2.12 Kernel Data Space 

Example 3-22 shows a dump of kernel data space from the specified starting virtual address to 
the specified ending virtual address. 



Example 3-22: 



Kernel Data Space 

V4.0 



RSX-llM-PLUS CRASH DUMP ANALYZER 
KERNEL DATA SPACE DUMP 



26-SEP-86 13:51 



PAGE 1 



VIRTUAL ADDRESS: 020000 



PHYSICAL ADDRESS: 00074200 



020000 


000000 


000000 


000000 


000000 


020010 


000000 


000000 


000000 


000000 


020020 


000000 


000000 


000000 


000000 


020030 


000000 


000000 


000000 


000000 


020040 


000000 


000000 


000000 


000000 


020050 


000000 


000000 


020052 


000000 


020060 


000000 


020060 


000000 


000000 


020070 


000000 


000000 


000000 


000000 


020100 


000000 


000000 


000000 


000000 



EE4 



EF 



3.2.13 Kernel Instruction Space 

Example 3-23 shows a dump of kernel instruction space from the specified starting virtual 
address to the specified ending virtual address. 



Example 3-23: 



RSX-llM-PLUS CRASH DUMP ANALYZER 
KERNEL INSTRUCTION SPACE DUMP 



Kernel Instruction Space 

V4.0 26-SEP-86 



13:51 



PAGE 1 



VIRTUAL ADDRESS: 020000 



PHYSICAL ADDRESS: 00020000 



020000 


012021 


012021 


011011 


020127 


fCHQ CHQ BSq EF9! 


! W 


020010 


172276 


001405 


012700 


177660 


!9FN SM CSH 6P! 


!>t 


020020 


012701 


172260 


000760 


012667 


!CSI 9F LP CR9! 


!A Otp 7 


020030 


152342 


012603 


000207 


010246 


!46R CQ$ CO BZV! 


!bT ft 


020040 


012702 


172200 


052703 


100000 


!CSJ 9D2 M.5 TSH! 


!B tCU 


020050 


106303 


006203 


103006 


016261 


!VT5 B C UqO DWY! 


!C 1 


020060 


000040 


000040 


012221 


005720 


! 2 2 CKY A5X! 


! P 


020070 


000405 


016061 


000040 


000040 


! FU DTQ 2 2! 


! 1 


020100 


012021 


005722 


105703 


100361 


!CHQ A5Z VNS TYI! 


! R C q 



3.2.14 Cache Dump 

The following example shows a sample cache dump listing, produced with the /CACHE switch. 
Noted sections are described as follows: 

O Device for which data exists in cache memory 

© Address of the Cache Extent Descriptor (CED) that describes the region of the disk read 
into cache 

© Starting logical block number on disk from which the data was read 

O Length (in octal) of the data read into cache memory from the disk, in 512-byte blocks 
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© Physical memory address where the disk data is located now in cache memory 
Example 3-24: Cache Information 



RSX-llM-PLUS CRASH D 


UMP ANALYZER 


V4.0 8 


-OCT-86 16 


20 


PAGE 1 


CACHE INFORMATION 












DUMP OF CACHE REGION: DEMO 

















DEVICE: DUO: 












O DESCRIPTOR 


© STARTING 


LOGICAL 


O LENGTH 




© PHYSICAL 


ADDRESS 


BLOCK NUMBER 


(DISK BLOCKS) 


ADDRESS 


01471310 


00000003 




10 




02102500 


01471250 


00013352 








02101500 


01470350 


00073041 








02063500 


01470410 


00073042 








02064500 


01470450 


00073043 








02065500 


01470250 


00073044 








02061500 


01470510 


00073045 








02066500 


01470550 


00073046 








02067500 


01470610 


00073047 








02070500 


01471350 


00073050 








02103500 


01471410 


00073051 








02104500 


01471450 


00073052 








02105500 


01471510 


00073053 








02106500 


01471550 


00073054 








02107500 


01471610 


00073055 








02110500 


01471650 


00073056 








02111500 


01471710 


00073057 








02112500 


01471750 


00073060 








02113500 


01472010 


00073061 








02114500 


01470650 


00073062 








02071500 


01470710 


00073063 








02072500 


01470750 


00073104 








02073500 


01471010 


00073105 








02074500 


01471050 


00073123 








02075500 


CACHE INFORMATION 












01471110 


00073124 








02076500 


01471150 


00073125 








02077500 


01471210 


00073255 








02100600 


01470310 


00073325 








02062500 
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Chapter 4 

Interpreting a Crash Dump Listing 

This chapter introduces basic concepts that can help you use CDA output listings to analyze 
the cause of a system failure. However, this chapter is not intended as a complete guide to 
interpreting a crash dump. 

4. 1 Helpful Concepts 

Two concepts are helpful in using CDA output listings to determine the cause of a system 
failure: 

• Determining what was mapped at the time of the system failure 

• Interpreting stack depth and the kernel stack 

4. 1 . 1 Determining Wiiat Was iVIapped 

To determine what was mapped at the time of the failure, look at the dump of the Kernel Page 
Address Registers on the first page of the CDA listmg (instruction and data space registers on 
RSX-llM-PLUS systems). This listing, titled Volatile Registers, is shown in Example 3-1. 

Example 4-1 is an example of the listing of the contents of the sixth and seventh words from 
a Kernel Page Address Registers dump. The contents of the sixth and seventh words are the 
block numbers of the task or driver that was mapped at the time of the system failure. You 
can determine what occupied that portion of memory from the memory map on the first page 
of partition information in the CDA output listing. Look under the BASE heading (for the base 
address of the mapped partition). 

You can use this information, along with data from the kernel stack and system common listings, 
to analyze the state of the system at the time of the failure. 
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Example 4-1: Kernel Page Address Registers 





KERN 


E L 




I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


077406 


000000 


177506 


000000 


077406 


000200 


077506 


000742 


077406 


000400 


077406 


001142 


077406 


000600 


077406 


001342 


077406 


001000 


077506 


001542 


077406 


010667 


077406 


010667 


077406 


011067 


077406 


011067 


077406 


177600 


077506 


177600 



4.1.2 Interpreting The Kernel Stack 

The system stack depth indicator, $STKDP, appears on the first page of the system common 
listing. The value of the stack depth indicator shows which state the system was in when 
it failed. The following lists shows the possible values of the stack depth indicator and the 
corresponding system states: 



$STKDP = 1 
$STKDP = 
$STKDP = -1,-2,-3,-4, 



Indicates User state 
Indicates System state 
Indicates Interrupt state 



Note that when the system is in Interrupt state, the stack depth value is negative. Two types 
of interrupt conditions can decrement stack depth: 

• A synchronous system trap (SST), which can be caused by any of the following: 

— A directive 

— A TRAP instruction 

— An illegal instruction 

— Another SST 

• The interrupt save routine ($INTSV) 

When an SST occurs, the following information from the current task is pushed onto the stack: 

The Processor Status Word (PSW) 

The Program Counter (PC) 

The address of return to DIRSV 

SST specific information 

R5 

R4 

R3 

R2 

Rl 

RO 
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When an interrupt occurs, the following are pushed onto the stack: 

PSW 
PC 

If a call to $INTSV is then issued, the following are pushed onto the stack after the PC: 

Address of return to $INTSV 

R5 

R4 

The stack depth is then decremented. If the value of $STKDP is and the currently mapped 
driver issues a call to the $FORK routine, the following items are pushed onto the stack: 

Return to $FORK 

R3 (Which replaces the return to $INTSV) 

R2 

Rl 

RO 

If the driver issues a call to $FORK when $STKDP is not 0, the registers are saved in a fork 
block, which is queued for later execution. 

Since interrupts can still occur, more of both basic types of stack contents (interrupt or $INTSV) 
can be pushed. If an SST occurs in the Executive, SST information will be pushed onto the 
stack, possibly followed by a system failure. 

This information, along with the kernel stack pointer SP(K), which appears on the first page of 
the CDA listing, can be used to interpret the contents of the dump of the kernel stack. 

The contents of the PC and the PSW before the failure appear on the first page of the CDA 
listing. You can compare this information to the contents of the PC and the PSW on the stack 
to help locate the cause of the failure. 

Refer to the RSX-llM-PLUS and Micro/RSX Guide to Writing an I/O Driver for a further 
description of the contents of the kernel stack. 



Interpreting a Crash Dump Listing 4-3 



Appendix A 



CDA Messages 



CD A displays a message on your terminal when it detects one of the error conditions described 
below. These messages reflect operational conditions. Do not confuse these messages with the 
diagnostic analysis messages that CDA generates during the analysis and prints in the analysis 
listing. 

Not all of the messages listed below terminate CDA analysis. Some are simply informational 
messages, and others warn you of nonfatal errors. Also, this list includes some ANALYZE 
/CRASH—DUMP command error messages. 

ANALYZE — Illegal crash Input specification, 

Severity: Fatal 

Explanation: You must include a crash-input device or file in the command line. Also, you 
must use the correct command line syntax when you specify the crash input. 

ANALYZE — Illegal crash output specification, 

Severity: Fatal 

Explanation: You must specify at least one output file or device specification. Also, you 
must use the correct command line syntax when you specify the crash output. 

ANALYZE — Illegal, contradictory, or ambiguous qualifiers, 

Severity: Fatal 

Explanation: You must use qualifiers with the correct file or device specification. Refer 
to the qualifier tables in Chapter 2 if you are unsure which file or device specification a 
qualifier modifies. Also, when you specify qualifier arguments, be sure to enclose them in 
parentheses. If you specify more than one argument for the same qualifier, separate the 
arguments with commas. 
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ANALYZE— Sorry, task not installed, 

Severity: Fatal 

Explanation: CDA is not presently installed in the system. If you are a nonprivileged user, 
refer to Chapter 1 for an explanation of how you can run CDA as an uninstalled task, or 
ask a privileged user (such as your system manager) to install CDA. If you are a privileged 
user, you can install CDA and then reenter your command line. 

CDA — ACP out of memory or not In execution, 

Severity: Analysis diagnostic 

Explanation: The partition containing the File Control Block (FCB) for the current logical 
unit number (LUN) was not in memory. 

CDA — Address out of range. 

Severity: Fatal 

Explanation: CDA was unable to read a block from the crash-input file. Possible causes for 
this are: 

• A device failure 

• A bad block on the volume 

• The crashed system had a corrupted data base 

• The binary file does not contain all of the crashed system's memory 
CDA — Analysis output must be directed to an explicit device or file, 

Severity: Fatal 

Explanation: CDA requires an explicit output file specification. There are no default output 
file names. 

CDA — Analysis terminated after n. pages, 

Severity: Informational 

Explanation: CDA terminated the analysis after generating n pages of analysis output. If you 
have not specified the /LIMIT switch in the CDA command string, this message indicates 
that CDA has generated more than 300io pages of output. 

CDA — Cache region Is not In memory. 

Severity: Warning 

Explanation: The requested cache region was not in memiory at the time of the system 
failure. 

CDA — Cache region was not found. 

Severity: Warning 

Explanation: No part of memory has been defined as the requested region. 
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CDA — Command I/O error, 

Severity: Fatal 

Explanation: The system returned an error when CDA attempted to read a command line. 
CDA — Command line syntax error, 

Severity: Fatal 

Explanation: CDA detected an error in the syntax of a CDA command line. CDA will point 
to the beginning of the error within the command line. 

CDA — Crash dump must be input from an explicit device or file. 

Severity: Fatal 

Explanation: The crash dump input file specification must be explicit. There is no default 
file specification for the crash dump input. 

CDA — Device driver missing, 
Severity: Fatal 
Explanation: You have not loaded the driver for the crash dump input device. 

CDA — Dump aborted - kernel PARs clobbered, 

Severity: Fatal 

Explanation: This message appears on mapped systems only. It indicates that the values 
contained in the kernel Page Address Registers are invalid. To restart the analysis, you 
must specify the /KMR switch. This switch forces CDA to use standard mapping values 
when converting kernel virtual addresses to physical memory addresses. 

CDA — Error reading crash dump, 

Severity: Fatal 

Explanation: The system returned an error when CDA attempted to read the crash dump 
file. This could be caused by: 

• A device failure 

• A bad block on the volume 

• On RSX-llM-PLUS systems, the device might not be mounted foreign 

CDA — Error reading file fiiename, 

Severity: Fatal 

Explanation: The system returned an error when CDA attempted to read the crash dump 
file. This could be caused by: 

A device failure 

A bad block on the volume 
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CDA — Error reading symbol file (iienome, 

Severity: Fatal 

Explanation: The system returned an error when CDA attempted to read the symbol table 
file indicated. Possible causes for the error are: 

• A device failure 

• A bad block on the volume 

• The specified symbol file was not an STB file 

CDA — Errors detected: n., 
Severity: Informational 
Explanation: CDA has detected n analysis errors during the run. 

CDA — Error writing analysis file, 

Severity: Fatal 

Explanation: The system returned an error when CDA attempted to write a line into the 
analysis listing file. This could be caused by: 

• A full volume 

• A problem with the device 

• A bad block on the volume 

CDA — Error writing dump die fiienome, 

Severity: Fatal 

Explanation: The system returned an error when CDA attempted to write into the binary 
output file. This condition could be caused by: 

• A full volume 

• A problem with the device 

• A bad block on the volume 

CDA — Exiting due to illegal trap - snapshot dump being attempted, 

Severity: Fatal 

Explanation: CDA has aborted after detecting an odd address or some other type of fault. 
If Postmortem Dump (PMD) is installed in the system, the system will generate a snapshot 
dump. This is an indication of a software problem. If you send a Software Performance 
Report (SPR) to DIGITAL for this type of failure, you should include any available dumps. 
Also, preserve the following until your SPR is answered: 

From the crashed system: 

— All applicable user task images 

— RSXllM.SYS 

— RSXllM.STB 
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- RSXMCMAC 

- All applicable privileged task images 

- Crash dump volume 

• From the system used for analysis: 

- RSX11M.SYS 

- RSXllM.STB 

- CDA.TSK 

CDA — Failed to assign LUN to Input device ddu, 

Severity: Fatal 

Explanation: The Assign LUN (ALUN$) directive failed when CDA attempted to use it to 
attach the specified input device before reading the crash dump from the device. ALUN$ 
fails if the device name in the CDA command line is invalid. 

CDA — Failed to extend page buffer - n. pages available, 

Severity: Informational 

Explanation: The Extend Task (EXTK$) directive failed when CDA attempted to use it to 
expand the page buffer. This problem causes the analysis to take longer, but the analysis 
continues with a buffer of n pages, each 256 words long. 

Note 

CDA uses the Extend Task directive to obtain additional buffering space. 
CDA does not use space allocated by a /INC= qualifier on the install 
command. 

CDA — Failed to open Input file filename, 
Severity: Fatal 
Explanation: One of the following conditions exists: 

• The specified device does not exist. 

• The volume is not mounted. 

• A problem exists with the device. 

• The specified directory does not exist. 

• The specified file does not exist. 

• You do not have read access privileges. 
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CDA — Failed to open output file filename, 
Severity: Fatal 
Explanation: One of the following conditions exists: 

• The specified device does not exist. 

• The volume is not mounted. 

• A problem exists with the device. 

• The specified directory does not exist. 

• The volume is full or the device is write-protected. 

• You do not have write access privilege to directory. 

CDA — Illegal switch, 

Severity: Fatal 

Explanation: You specified an unknown switch or used a legal switch with the wrong file 
specification. CDA will point to the error within the command line. 

CDA — Inconsistency In dynamic storage, 

Severity: Informational 

Explanation: CDA detected an inconsistency while scanning the pool pointers. This condition 
could be associated with the crash. However, it may mean that you specified the wrong 
executive symbol table file. 

CDA — Indirect command syntax error, 
Severity: Fatal 
Explanation: The name of the indirect command file (@filename) is syntactically incorrect. 

CDA — indirect file open failure, 

Severity: Fatal 

Explanation: CDA could not open an indirect command file specified as "@filename" in the 
CDA command line. 

CDA — Invalid address range, 

Severity: Fatal 

Explanation: You specified an address that was not consistent with Active Page Register 
(APR) mapping. 

CDA — List count expired. 

Severity: Analysis diagnostic 

Explanation: The linked list of data structures has too many entries. The list may be 
corrupted or contain a loop. 
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CDA — Loop found in cache extent descriptors at nnnnn, 

Severity: Analysis diagnostic 

Explanation: A loop was found in cache extent descriptors at physical address nnnnn. 
CDA — Loop found in cachie statistics bloci<s at nnnnn, 

Severity: Analysis diagnostic 

Explanation: A loop was found in the cache statistics blocks at physical address nnnnn. 
CDA — Loop found in ilnited iist in pool at nnnnn, 

Severity: Analysis diagnostic 

Explanation: A loop was found in a linked list in kernel data space at location nnnnn. 
CDA — Maximum indirect file depth) exceeded. 

Severity: Fatal 

Explanation: You exceeded the maximum allowable number of nested indirect command 
files. (CDA only permits one indirect command level.) 

CDA — No devices tiave cactiing associated with this region. 
Severity: Informational 
Explanation: The region specified has no devices specified for caching. 

CDA — No input file specified, 
Severity: Fatal 
Explanation: You did not specify a crash dump input file. 

CDA — No output file specified. 
Severity: Fatal 
Explanation: You did not specify an output file. 

CDA — Output dump fliename must be explicit. 
Severity: Fatal 
Explanation: You did not specify a valid output file. 

CDA — Pool llnic error found - continuing. 

Severity: Analysis diagnostic 

Explanation: CDA detected a link error while scanning the pool free block pointers ($CRAVL). 
This condition can be associated with the crash. It can also mean that you specified the 
wrong Executive symbol table file. If the latter is true, the entire analysis wUl be meaningless 
and you should abort CDA. 
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CDA— Premature end of dump input - filename being zero-filled, 
Severity: Informational 

Explanation: CDA reached the end of the medium (or the end-of-file mark on a magnetic 
tape) before the crash dump output file had been completely filled. If you expected the file 
to be completely filled by the dump, this condition could indicate a problem. 

CDA — Processor n failed to dump Its registers, 
Severity: Informational 

Explanation: On a multiprocessor system, when the system crashes, each on-line processor 
is notified by an interrupt. If the processor does not respond to the interrupt (for example, 
if it halted or is off line), it won't dump its registers into the crash buffer. CDA notes this 
and prints the informational message. 

CDA— Redirect error CU.RED=0), 

Severity: Analysis diagnostic 

Explanation: CDA detected an error in the pointer to the Unit Control Block (UCB) of a 
redirected unit. This condition may be associated with the cause of the crash. 

CDA— Requested partition Is not a cache region. 
Severity: Warning 
Explanation: The partition you specified is not a part of the cache region. 

CDA— Symbol symbolname not defined in symbol file, 
Severity: Fatal 

Explanation: CDA did not find a symbol that it required for the analysis in the specified 
Executive symbol table file. You have probably entered the wrong file name or have 
mistakenly used the default file name. 

CDA — Symbol file filename has illegal format, 

Severity: Fatal 

Explanation: The specified Executive symbol table file has an improper format, probably 
caused by entry of the wrong file name. However, this message could also indicate a 
problem with the device or medium on which the file is located. 

CDA— Task 'taskname' not In memory, 

Severity: Analysis diagnostic 

Explanation: This message can be caused by two conditions: 

• You have requested a dump of a task which does not have an entry in the System Task 
Directory. 

The task has an entry in the System Task Directory, but it is marked out of memory. 
You can verify the state of the task by examining a dump of the Task Control Blocks. 
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CDA — Transfer complete - ddu may be unloaded, 

Severity: Informational 

Explanation: The transfer of the crash dump to the output file is finished; you may unload 
the crash dump device. This message occurs only when you have specified a binary file in 
the output of the command string to CDA. 

CDA — Unknown AST type, 

Severity: Analysis diagnostic 

Explanation: CDA has detected an AST block that is not one of the following valid types of 
ASTs: 

• Unsolicited character AST 

• Buffered I/O AST 

• Emit status AST 

• Completion AST from: 

QIO$ 

MRKT$ 

SPWN$ 

CNCT$ 

CINT$ 

• Specified AST from: 

SFPA$ 
SRDA$ 
SRRA$ 
SPFA$ 

CDA — Unknown get command line error. 
Severity: Fatal 
Explanation: An unrecognized error occurred when CDA attempted to read a command line. 

CDA— $PKVAL link error at n -FWD PTR = n, 

Severity: Analysis diagnostic 

Explanation: CDA detected a link error while scanning the pool free-packet list $PKVAL. 
This condition can be associated with the crash. It can also mean that you specified the 
wrong executive symbol table file. 



CDA Messages A-9 



Appendix B 



Definitions of Values in Low Core IVIemory Dump 
and System Common Alphiabetized Dump 



B. 1 Low Core Memory Dump 

The following is a source-code listing defining the values in the Low Core Memory Dump 
portion of a crash dump. 



Lowcore data area 



; PROCESSOR IMPURE DAT 




.IF DF 


M$$PRO 


$PR0C2: 
$PROCN: 


.BYTE 
.BYTE 

.ENDC 






$STKDP: 
$TKTCB: 
$CURPR: 


.WORD 
.WORD 
.WORD 





$PRTAB 


$SGFFR: 


.WORD 





$HFMSK: 


.WORD 
.WORD 


HF.EIS 
H2.BRG 



$HFEND: 



; PROCESSOR NUMBER * 2 
; PROCESSOR NUMBER 



STACK DEPTH INDICATOR 
POINTER TO CURRENT TASK TCB 
POINTER TO CURRENT TASK PRIORITY 



; POINTER INTO STACK FOR $SGFIN 

HARDWARE MASK WORD 
SECOND HARDWARE MASK WORD 
H2.BRG IS SET BECAUSE THE VIRGIN BOOT 
OF A PROFESSIONAL 300 SERIES MACHINE 
IS CURRENTLY ALWAYS DONE ON A BRIDGE 
SYSTEM AND INITL DOES NOT SET THIS BIT 
REF. LABLE TO DELIMIT HARDWARE FEATURE 
MASK WORDS. 



$RBTAD IS THE ADDRESS OF THE RE-BOOT ENTRY TO THE BOOT ROM 
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.IF DP B$$O0T 
$RBTAD::.WORD B$$OOT 

.ENDC ; DF B$$OOT 



; ADDRESS OF REBOOT ROM ENTRY 



THE FOLLOWING BYTE IS A FLAG SET WHENEVER SUPERVISOR I SPACE IS 
MAPPED READ/WRITE, MEANING THE PDR'S MUST BE CLEARED ON CONTEXT SWITCH 



SUPER I SPACE R/W FLAG 
CONTEXT SWITCH DISABLE FLAG 
BIAS OF CURRENT TASK HEADER 



$SIRWF: 
$CXDBL: 
$SAHDB: 


.BYTE 
.BYTE 








.IF DF X$$HDR 




.WORD 





$SAVSP: 


.WORD 
.IFTF 


$UMR4 


$SAHPT: 


.IFT 






.WORD 







.ENDC 




$HEADR: 


.WORD 







.IF DF F$$MAP 


$FMAPP: 


.WORD 







.ENDC 


, DF F$$MAP 


$RqSCH: 


: .WORD 


$RQTAB 



; SAVED SP - ALWAYS POINTS TO UMR4 

; VIRTUAL ADDRESS OF CURRENT TASK HEADER 



; POINTER TO CURRENT TASK HEADER 



; POINTER TO FAST MAP AREA OF HEADER 



; POINTER TO CURRENT RESCHEDULE POINTER 



THE FOLLOWING CELLS CONDITIONALLY DESCRIBE THE EXECUTIVE CONFIGURATION 
IF KERNEL DATA SPACE IS SUPPORTED. 



.IF DF K$$DAS 
$ROEND::.WORD 



«<$EXEND+77>&177700>/100>&1777 ; LENGTH IN 32 WD BLOCKS 

:0F R/0 SECTION OF EXECUTIVE 



$SCMOF::.WORD 
.WORD 

$ICAVL::.WORD 
.WORD 




3 

$ICBEG 




.IFF 



$SCMOF:: 



OFFSET TO DATA SPACE OR IF NOT LOADED 
ALLOCATION SIZE MASK 
BEGINNING OF ALLOCATED ICB POOL 
DUMMY SIZE FOR FIRST BLOCK 



;MAKE SURE SYMBOL IS ALWAYS DEFINED 



.ENDC 



UMR ALLOCATION LISTHEAD AND WAIT QUEUE LISTHEAD. THE ALLOCATION 
LISTHEAD DOUBLES AS A DESCRIPTOR OF THE UMRS STATICALLY ALLOCATED TO 
THE EXEC AND ANYONE ELSE. 
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.IF DF M$$EXTftU$$UMR 



$UI4RHD;:.VirOItD 
.WORD 
.WORD 

$UMRWT::.WORD 

.ENDC 





UBMPR 

N$$UMR 

0,.-2 



MAPPING ASSIGNMENT BLOCK LISTHEAD 
ADDRESS DF FIRST ASSIGNED UMR 
NUMBER OF UMR'S STATICLY ASSIGNED * 4 
UMR WAIT QUEUE LISTHEAD 



DF M$$EXTi:U$$UMR 



DATA STRUCTURES FOR EXECUTIVE IDLE CODE 



$IDLCT 
$IDLFL 
$IDLPT 



.BYTE 

.BYTE 

.WORD 7760 

.WORD 



SYSTEM POWER FAIL STACK 



IDLE PATTERN COUNT BYTE 

IDLE PATTERN FLAG BYTE 

IDLE PATTERN WORD 

WORKING STORAGE FOR IDLE PATTERN 



•IF DF P$$RFL 



.IF DF M$$PRO 

$PWKAO::.BLKW M$$PRO 

$PWCSR: : .WORD FKCSR 

FKCSR: .WORD 

.ENDC 



STORAGE FOR KINARO IN CPA'S AREA 

POINTER TO I 1ST CSR 

CPA CSR (WHEN NO I 1ST PRESENT) 



$PWBTM: :.BLKW 



;R0 THRU R5 AND SP 



. IF DF M$$EXT 
.BLKW 31. *2 
.ENDC 



lUNIBUS MAPPING REGISTERS 



.BLKW 25. 



; MEMORY MANAGEMENT REGS ft USER SP 



.IF DF F$$LPP 
.BLKW 27. 
.ENDC 



; FLOATING POINT REGISTERS 



.IF DF K$$DAS 
.BLKW 8. 
.ENDC 



; KERNEL D SPACE APR'S 



.IF DF S$$LIB 

.BLKW 16. 

.BLKW 16. 

.BLKW 1 

.ENDC 



SUPER I SPACE PARS AND PDRS 
SUPER D SPACE PARS AND PDRS 
SUPER SP 
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.IF DF U$$DAS 

.BLKW 16. 

.ENDC ; DF U$$DAS 



$PWSTK==.-2 
$POWSP:: .BLKW 1 
.ENDC 



lUSER D SPACE REGISTERS 

;REF LABEL 

; SAVED SP FOR POWERFAIL STACK 



FLOATING POINT SUPPORT WORK AREA 



. IF DF F$$LPP 



$FLSTS 
$FLFRK 
$FLTCB 



.BLKW 
.WORD 
.BLKW 

.ENDC 



2 

$FLFTB 

1 



FLOATING POINT STATUS 

POINTER FOR FLOATING POINT FORK BLOCK 

ADDRESS OF TCB CAUSING EXCEPTION TRAP 



SAVE AREA FOR ERROR LOGGING NONSENSE INTERRUPT HANDLING 



.IF DF E$$LOGftE$$NSI 



$VID 


: .BLKB 


1 


$NSI 


.BYTE 


- 


$OPS 


.BLKW 


1 


$OPC 


.BLKW 


1 



$ERLFK::.WORD $PBEZ 



VECTOR ID STORAGE 

RECURSION COUNTER 

OLD PS STORAGE 

OLD PC STORAGE 

POINTER TO ERROR LOGGING FORK BLOCK 



.ENDC : DF E$$LOGftE$$NSI 

DATA STRUCTURES FOR PARITY SUPPORT 
EXEC PARITY ERROR MESSAGE 

.IF DF P$$RTY 

.NLIST BEX 

$EXMSG::.ASCIZ <15><12>/***EXEC PARITY ERROR ST0P***/<15><12><12> 

.LIST BEX 
.EVEN 

INTERRUPT RECURSION LEVEL COUNTER 

$PARLV:;.WORD -1 ; 

PARITY CONTROL STATUS REGISTER ADDRESS TABLE 
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sic>i<>ic:i!*** NOTE WELL ! ******* 

THE FOLLOWING TABLES ARE REFERENCED IN INITL AND PARTY. AS WELL AS 
BY SAVE AND HRC. THE ADJACENCY OF THE ITEMS STARTING AT $PARTB AND 
INCLUDING $MEMR1. $MPCSR. AND $CPUER IS NOT ONLY ASSUMED, IT IS 
CRUCIAL AND MUST BE PRESERVED. NOTE ALSO THAT ANY CHANGE IN THE 
STRUCTURE OF $PARTB SHOULD PROBABLY BE REFLECTED IN $MKCSR AND $MKCS2. 
BOTH FOUND IN SYSCM. 



$CSRTB : : 
$MEMR6: : 



$PARTB : 



.BYTE 
.BYTE 
.BYTE 
.BYTE 

.BLKW 

.IFTF 

-.WORD 

.IFT 



; REFERENCE LABEL 
16..<172100&177400>/400.172100&377 ; MEMORY PARITY CSR'S 
6. .<177740&177400>/400,177740&377 ; CACHE CONTROL CSR'S 
1. ,<177766&177400>/400,177766&377 ; CPU ERROR REGISTER 
;END OF TABLE 



DF P$$RTY 



; DUMMY STORAGE FOR MEMORY ERROR REGISTER 



; DUMMY CSR FOR NONEXISTANT REGISTERS 



DF P$$RTY 



TABLE OF CSR ADDRESSES. IF THE CSR DOES NOT EXIST. THE ENTRY POINTS 
TO $PARTB ABOVE. THIS MUST BE THE CASE SO THAT CODE REFERENCING THE 
CSRS PRIOR TO THE CSR SCAN (SUCH AS THE LOCK$ $EXECL IN INITL) WILL 
ACCESS A DUMMY LOCATION. NOT LOCATION 0. 



$MEMR1 : : 



$MPCSR: 



$CPUER: : 



.REPT 


16. 


-WORD 


$PARTB 


.ENDR 




.REPT 


6. 


.WORD 


$PARTB 


.ENDR 




.IFTF 


; DF P$$RTY 


.WORD 


$PARTB 


.IFT 


; DF P$$RTY 



; MEMORY PARITY CSR TABLE 

; POINT TO DUMMY CSR 

; VECTOR OF CACHE CSR ADDRESSES 

; POINT TO DUMMY CSR 



;CPU ERROR REGISTER 
: POINT TO DUMMY CSR 



PDP-11/70 CACHE PARITY STATUS TABLE 





.IF DF 


P$$D70 




$MSTAT: 


: .BLKW 


2 


FIRST TWO PARITY CSR'S 


$STAT: : 


.BLKW 


1 


MEMORY STATUS REGISTER 




.BLKW 


3 


LAST THREE PARITY CSR'S 


$ERTRK: 


r.BYTE 


44.120 


ADDRESS/DATA GROUP 




.WORD 





TIME OF LAST ERROR 




.BYTE 


30.240 


ADDRESS/DATA GROUP 1 




-WORD 





TIME OF LAST ERROR 




.WORD 





END OF TABLE 



Definitions of Values in low Core Memory Dump and System Common Alphabetized Dump B-5 



NEW CACHE PARITY CSR CONTENTS 

$MPCTL::.WDRD 1 
.ENDC 



.IFF : DF P$$RTY 



$CSRTB : : 



; REFERENCE LABEL 



.ENDC ; DF P$$RTY 
DATA AREA FOR DYNAMIC EXEC DEBUGGER INTERFACE 



.IF DF D$$DXD 



$DXDK5::.W0RD 
$DXDRL::.WORD 
$DXDEP: : .WORD 



SAVED KINAR5 FOR DXD 
RELOCATION BIAS FOR DXD 
ENTRY POINT TO DXD 



.ENDC 



D$$DXD 



DATA AREA FOR BUGCHECK SUPPORT 



$BCFAC::.WORD 
$BCERR: : .WORD 



; FACILITY CODE 
; ERROR CODE 



DATA AREA FOR SYSTEM CRASH MODULE 



.IF DF C$$GDA 
$CRBAE: : .WORD 



; DEFINE EXISTENCE OF BAE REGISTER 



.IIF EQ C$$CDA-12 CDA$MS=0 
.IIF EQ C$$CDA CDA$MS=0 



.IF DF CDA$MS 



$MSCR1 : 
$MSCR2 : : 



.BLKW 5 

.WORD $MSCR3 

.WORD 
.WORD 14. 
.WORD CI 

$MSCR3:: .BLKW 7 

.ENDC ;DF CDA$MS 

.IIF EQ C$$CDA-16 
IIF EQ C$$CDA-17 



;MS RESIDENT CRASH DRIVER 
; LOADABLE CRASH DRIVERS 

;MS RESIDENT OR LOADABLE CRASH DRIVER 



COMMAND BUFFER FOR MS CRASH DUMP 

NEED FOUR WORDS ON DOUBLE WORD BOUNDARY 

CHARACTERISTICS DATA 

LOW ORDER 16 BITS OF MESSAGE 

BUFFER ADDRESS 

HIGH ORDER 2 BITS 

SIZE OF THE MESSAGE BUFFER 

FLAG WORD 

MESSAGE BUFFER 



CDA$DU=0 
CDA$MU=0 



.IF DF CDA$DU!CDA$MU!H$$GEN 
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CRASH DATA BASE FOR DU DEVICES 

*** NOTE WELL *** 

ANY CHANGES TO THIS DATABASE MUST ALSO BE MADE IN CRASH. MAC 



COMMAND AND RESPONSE PACKETS 





.WORD 


60 




.WORD 


1 


CMDPKT: 


.WORD 


1 




.BLKW 


23. 




.BLKW 


2 


RSPPKT: 


.BLKW 


24. 




.BLKW 


2 


; COMMAND RINGS 




RINGS: 






RSP: 


.WORD 


RSPPKT 




.WORD 


100000 


CMD: 


.WORD 


CMDPKT 




.WORD 


100000 


; INITIALIZATION TABLE 


$MUCSH: 






$DUCSH: 


.WORD 


CMDPKT. RSPPKT 




.WORD 


100000. RINGS 




.WORD 


0, 1 




.WORD 


RSP 




.ENDC 






.IFF 


; DF C$$CDA 


$BCPC : : 


.WORD 







.IFT 


: DF C$$CDA 


$BCPC:: 






$CRUPC: 


.WORD 





$CRUST: 


.WORD 






PACKET LENGTH 

VIRTUAL CIRCUIT AND CREDIT/DEBIT FIELD 

COMMAND PACKET AREA 

ENVELOPE 

RESPONSE PACKET AREA 



RESPONSE PACKET RING 

PACKET "OWNED" BY CONTROLLER 
COMMAND PACKET RING 

PACKET "OWNED" BY CONTROLLER 



ADDRESSES OF PACKETS 

STEPS 1 AND 2 

STEPS 3 AND 4 

ADDRESS OF RESPONSE RING 



;BUGCHECK PC FOR TYPE DIRECT 



; ALTERNATE LABEL FOR CRASH PC 

; USER PC IS STORED HERE 
;USER PS IS STORED HERE 

.NLIST BEX 
$CRMSO::. ASCII <15><12><12>/CRASH ~ CONT WITH SCRATCH MEDIA ON / 

ICRDEV:: ; REFERENCE SYMBOL 
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IIF EQ 
IIF EQ 
IIF EQ 
IIF EQ 
IIF EQ 
IIF EQ 
IIF EQ 
IIF 
IIF 
IIF EQ 
IIF EQ 
IIF EQ 
IIF EQ 
IIF EQ 
IIF EQ 



EQ 
EQ 



C$$CDA-1. 

C$$CDA-2, 

C$$CDA-3. 

C$$CDA-4. 

C$$CDA-5, 

C$$CDA-6, 

C$$CDA-7. 

C$$CDA-10, 

C$$CDA-11 , 

C$$CDA-12, 

C$$CDA-13, 

C$$CDA-14. 

C$$CDA-15, 

C$$CDA'16, 

C$$CDA-17 



IIF £q <.-$CRDEV> 



.ASCII 
.ASCII 
.ASCII 
-ASCII 
.ASCII 
.ASCII 
.ASCII 
.ASCII 
.ASCII 
.ASCII 
.ASCII 
.ASCII 
.ASCII 
-ASCII 
.ASCII 



/DT/ 
/DK/ 
/MT/ 
/MM/ 
/DB/ 
/DM/ 
/DL/ 
/DD/ 
/DR/ 
/MS/ 
/DX/ 
/DY/ 
/MF/ 
/DU/ 
/MU/ 



NOT SUPPORTED 
NOT SUPPORTED 
NOT SUPPORTED 



.ASCII /XX/ ; ALWAYS ALLOW FOR A DEVICE NAME 



$CRUNT::.BYTE 
.ASCIZ 



<60+C$$RUN> 
<15><12><12> 



$CRMS1 
$CRMS2 
$CRMS4 
ICRMSS 
$CRCPU 



.IF DF M$$PRO 

.ASCIZ <15><12>/CRASH 

.ASCIZ <15><12>/CRASH - 

.ASCIZ <15><12>/CRASH - 

.ASCIZ <15><12>/CRASH - 

.ASCIZ /?/ 

.ENDC 



WAITING FOR PROCESSORS TO QUIESCE/ 
PROCESSOR REGISTERS HAVE BEEN SAVED/ 
- SANITY TIMER EXPIRED ON PROCESSOR CP/ 
CRASH REQUESTED BY PROCESSOR CP/ 



$CRMS3 
$CRMS6 
$CRMS7 



-ASCIZ <15><12>\CRASH — I/O ERROR ON CRASH DUMP DEVICE\ 
.ASCIZ <15><12>/CRASH — ILLEGAL CRASH DEVICE/ 
.ASCIZ <15><12>/CRASH — CRASH DRIVER NOT LOADED/ 



; ALL THE SECTIONS OF THE BUGCHECK MESSAGE MUST BE CONTIGUOUS 

$BCMSG::. ASCIZ <15><12>/SYSTEM FAULT DETECTED AT PC=/ 

•ASCIZ / FACILITY*/ 

.ASCIZ / ERROR CODE=/ 

-ASCIZ <15><12><12> 



-BLKB 6 
$BCBUF::-BYTE 

-LIST BEX 



; BUFFER FOR OCTAL CONVERSION 
;0F VALUES IN CRASH 



.ENDC 



DF C$$CDA 



-IF DF A$$CNT 
$BILNG::.BYTE 1 

.IFF 
$BILN6:: 

.ENDC 



; BILLING IS INITIALLY OFF 



.IF DF S$$LIB 
$SUPFL;:.BYTE 



: SUPERVISOR WINDOW FLAG 
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.ENDC 


; DF S$$LIB 




.EVEN 






.IF DF C$$CDA 


$CRSBF: 


.BLKW 
: .BLKW 


6 
177. 


$CRSST= 


= .-2 






.IF EQ 


C$$CDA 




PBNH = 
PBNL = 








.IFTF 




$CRSBN: 
$CRSCS: 
$CRDMP : 


:.WORD 

:.WORD 

:.BYTE 

.BYTE 


PBNH.PBNL 

PBNH+PBNL 






$CRPAR: 








.IFT 


; EQ, C$$CDA 




.WORD 







.ENDC 


; EQ, C$$CDA 




.ENDC 


; DF C$$CDA 




.IF DF 


A$$CNT 


$STHTM: 


:.BLKW 
-IFF 


2 


$STRTM: 


.ENDC 





*** THE FOLLOWING MUST BE ADJACENT 



STACK AREA FOR SUBROUTINE CALLS 
CRASH STACK IS THIS SIZE (NOT 
169. +4 AS PREVIOUSLY THOUGHT) 
(SEE CRASH. MAC FOR FORMAT) 
TOP OF CRASH STACK 

*** ABOVE MUST BE ADJACENT 
LOADABLE CRASH DRIVER SUPPORT 

; STARTING DEVICE ADDRESS 

; UNKNOWN 



STARTING DEVICE ADDRESS 

CHECKSUM OF DEVICE ADDRESS 

FLAG INDICATING REGS HAVE BEEN SAVED 

PRESERVE WORD ALIGNMENT 



iP.REL OF LOADED CRASH DRIVER 



; ABSOLUTE TIME OF CONTEXT SWITCH TO TASK 



HERE WE DEFINE A SINGLE "FAKE WORD" WHICH RECEIVES ALL THE ADDRESSES 
FOR THINGS WHICH ARE NOT GENNED INTO THE SYSTEM. BUT WHICH REQUIRE 
THAT THE ADDRESSES ALWAYS BE RESOLVED FOR TASKBUILDING MCR. ETC. 
THIS ONE (IN LOWCR) IS TO BE USED FOR I SPACE REFERENCES AND CPU 
SPECIFIC INFO (ALSO THINGS WHICH MUST BE ACCESSED WHEN D SPACE IS 
TURNED OFF) . AND THE ONE IN SYSCM IS USED FOR D SPACE LOCATIONS 



$WPBR: 



.IF NDF R$$WPT 



FAKE = 
.ENDC 



NDF R$$WPT 



.IF NDF P$$RTY 



$PARLV: : 
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FAKE = 







.ENDC 


; NDF P$$RTY 




.IF NDF D$$DXD 


$DXDEP : 
$DXDK5: 
$DXDRL : 








FAKE = 







.ENDC 


; NDF D$$DXD 




.IF DF 


FAKE 




.WORD 


-1 




.ENDC 


; DF FAKE 



;FAKE DATA LOCATION FOR ALL OF THE 
; ABOVE 



**-$NSO . $NS1 . $NS2 . $NS3 , $NS4 . $NS5 . $NS6 . $NS7- 
NONSENSE INTERRUPT IDENTIFIER ROUTINES 

EACH OF THESE ROUTINES IS VECTORED TO BY ONE DF A GROUP OF 16 
UNUSED VECTORS. THE VECTORS ARE SUB-CODED IN THE PS CONDITION CODES. 



.IF DF M$$PRO 

IN A MULTIPROCESSING SYSTEM, SOME STACK SPACE IS NECESSARY WHEN 
THE CPU IS INTERRUPTED. THE M9312MP BOOTSTRAP SETS R6 TO THE 
VALUE POINTED TO BY PHYSICAL ZERO. THIS IS THAT AREA. 



.BLKW 20. 
.ENDC 



: STACK SPACE FOR IIST 



$NSO 
$NS1 
$NS2 
$NS3 
$NS4 
$NSB 
$NS6 
$NS7 



NSI 

.WORD 

NSI 

.WORD 

NSI 

.WORD 

NSI 

.WORD 

NSI 

.WORD 

NSI 

.WORD 

NSI 

.WORD 

NSI 

.WORD 



20 



40 



60 



100 



120 



140 



160 



CALL COMMON ROUTINE 
GROUP 0-17 

GROUP 20-37 

GROUP 40-57 

GROUP 60-77 

GROUP 100-117 

GROUP 120-137 

GROUP 140-157 

GROUP 160-177 



INDIRECT POINTERS INTO MULTIPROCESSOR TABLES 
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.IF DF M$$PRO 



$TKPTR 

$MPSWT 
$CPURM 
$CPCRM 
$TTUQP 



.WORD 
.WORD 
.WORD 
.WORD 
.WORD 



$TKTAB 
$MPTAB 
$URMTB 
$CRMTB 
$TTUQ 



POINTER INTO CURRECT TASK TABLE 
POINTER INTO CPU STATUS TABLE 
POINTER INTO CPU URM TABLE 
POINTER INTO COMPLEMENTED RUN MASK TBL 
TTDRV MULTIPROCESSOR POINTER 



MULTIPROCESSOR LOCAL MEMORY WORDS. 



$CPBIT::.WORD 1 
$FRKCT::.WORD 

.ENDC 
KXJll SPECIFIC LOCATIONS 



.IF DF C$$KXJ 



$KXVC1 
icSFSV 
$CSHSV 
IKXPTR 
$KXBAS 



$KXVC1 
$CSFSV 
$CSHSV 
$KXPTR 
$KXBAS 



.BLKW 
.BLKW 
.BLKW 
-BLKW 
.BLKW 

.IFF 



: PROCESSOR BIT FOR USE IN MASKS 
; NUMBER OF FORK BLOCKS DEQUEUED 



KXJ SUPPORTED? 

KXJ VECTOR 1 - DRIVER COMMUNICATION 
SAVED KXJ CSR F - FULLY SHARED MEMORY 
SAVED KXJ CSR H - " " » 
POINTER TO KXJ DRIVER'S DCB 
BASE ADDRESS OF KXDRV 



.ENDC ; C$$KXJ 



REMOTE SYSTEM SPECIFIC LOCATIONS 



.IF DF C$$RMT 

$XXLOW::.BLKW 1 
$XXHGH::.BLKW 1 



.IFF 

$XXLOW:: .BLKW 1 

$XXHGH::.BLKW 1 

.ENDC ; C$$RMT 



.END 



REMOTE HOST 

FIRST GENERIC DCB ADDRESS 

LAST GENERIC DCB ADDRESS 

USED TO IDENTIFY A GENERIC DEVICE 
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B.2 System Common Alphabetized Dump 

The following is a source-code listing defining the values in the System Common Alphabetized 
Dump portion of a crash dump. 



System common data area 



NULL TASK CONTROL BLOCK 

THIS TCB TERMINATES THE SYSTEM AND ACTIVE TASK LISTS. IT MUST HAVE 
A PRIORITY OF ZERO AND ALWAYS BE BLOCKED. REQUIRED POSITIONS ARE 
ENFORCED BY THE "ASSUME" MACRO. 



$CMBEG:: 



; BEGINNING OF SYSCM AREA FOR CDA 



$ACCLK MUST REFERENCE THE SAME TWO WORDS AS $ABTIM FOR ACCOUNTING TO 
WORK, UNLESS ACCOUTING HAS ITS OWN CLOCK. IN THIS CASE, $ACCLK WILL 
BE THE ADDRESS OF WHERE ACCOUNTING CAN ACCESS IT. ACCOUNTING WILL 
USE A TWO WORD $ABTIM IF A PRIVATE CLOCK IS NOT AVAILABLE 



ABSOLUTE TIME CLOCK FOR ACCOUTING 
ADDITIONAL WORD FOR $ABTIM 
ABSOLUTE TIME COUNTER 
T.LNK-ACTIVE TASK LIST LISTHEAD 
T.PRI MUST BE ZERO 
T.PRI-NULL TASK PRIORITY IS ZERO 



$ACCLK: 






$ABTM2: 


: .WORD 





$ABTIM: 


:.WORD 





$ACTHD: 


:.WORD 






ASSUME 


. -$ACTHD ,T . PRI 




.BYTE 







.IF DF 


M$$PRO 


$NCPU: : 


.BYTE 
.IFF 


M$$PRO 


$NCPU: : 


.BYTE 
.ENDC 





$COMEF: 


:.WORD 







.WORD 





$HRCPT: 


:.WORD 





$DEVHD: 


:.WORD 


$DEVTB 


$TKNPT: 


:.WORD 





$SHFPT: 


: .WORD 





$CKCNT: 


: .WORD 


K$$CNT 


$CKCSR: 


: .WORD 


K$$CSR 




.IF EQ 


K$$CSR- 177546 


$CKLDC: 


: .WORD 
-IFF 





$CKLDC: 


:.WORD 
.ENDC 


K$$LDC 



;T.IOC - NUMBER OF PROCESSORS IN SYSTEM 



;T.IOC - NOT MULTIPROCESSOR SYSTEM 



T.DPCB-COMMON EVENT FLAGS 1-16 
T.NAM-COMMON EVENT FLAGS 17-32 
T.NAM+2-P0INTER TO HRC. . . TCB 
T.RCVL-PTR TO FIRST DEVICE CONTROL BLOCK 
T.RCVL+2-P0INTER TO TKTN TCB 
T.ASTL-POINTER TO SHUFFLER TCB 
T.ASTL+2- ADDRESS OF CLOCK COUNT REG 
T.EFLG-ADDR OF CLOCK CNTRL STATUS REG 



;T.EFLG+2-CL0CK LOAD COUNT 



;T.EFLG+2-CL0CK LOAD COUNT 
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$SYUIC: 


:.BYTE 


54.1 




ASSUME 


.-lAUTHD.T.TCBL 




-WORD 







ASSUME 


.-$ACTHD. T.STAT 


$EXSIZ: 


: .WORD 


$SYTOP 


IPWRFL: 


: .WORD 





$SIGFL: 


:.WORD 







.WORD 





$FXRPT: 


:.WORD 





$LSTLK: 


:.WORD 







.WORD 


3 




.IF NDF K$$DAS 



$ICAVL:: 



T.UCB-DEFAULT MAPPED SYSTEM UIC 
T.TCBL MUST BE ZERO 
T.TCBL-LINK TO NEXT TCB 
T.STAT MUST BE NONZERO 
T.STAT-ADDR OF LAST BYTE IN EXEC 
T.ST2-P0WERFAIL RECOVERY REQUEST FLAG 
T.ST3-TASK WAITING FOR SIG EVENT 
T.DPRI MUST BE 0, T.LBN - UNUSED 
T.LBN+1 -POINTER TO PARITY ERROR TASK 
T.LDV-LOCK WORD (TCB ADDRESS OF OWNER) 
T.PCB-CONSTANT FOR ALLOCATION ROUTINES 



:ICB POOL SAME AS CORE POOL IF NO D SPACE 



.ENDC 



$CRAVL::.WORD $SYBEG ;T.MXSZ-ACTIVE TASK LIST LISTHEAD 

ASSUME .-$ACTHD,T.ACTL ;T.ACTL MUST BE ZERO 



.IF NDF M$$PRO 



$K6TAB:: 



: REFERENCE LABEL FOR MAPPING IN 
; NON-MULTIPROCESSOR SYSTEM 



.ENDC 



.WORD 



;T.ACTL-NEXT ACTIVE TASK-DUMMY BLK SIZE 



END OF SUPERIMPOSED AREA-REMAINING SYSTEM COMMON AREA 



$ACPTK: 





-IF DF 


R$$AMD 




.WORD 







.ENDC 


DF R$$AMD 


$VERTK: 


:.WORD 





$LOGHD: 


:.WORD 





$CFLPT: 


:.WORD 





$MOULS: 


:.WORD 





$LBUIC: 


: . BYTE 


54,3 


$NTUIC: 


:.BYTE 


54,1 


$SPMAX: 


: .WORD 





ISPMVC: 


:.BLKW 


1 


$HKSTS: 


:.BLKW 


1 



SPM ENTRY VECTORS 



;TCB POINTER FOR DEFAULT FllACP 



TCB POINTER FOR VERIFICATION TASK 

LOGICAL DEVICE ASSIGNMENT LISTHEAD 
POINTER TO FIRST CHECKPOINT FILE PCB 
MOUNT LIST 
LIBRARY UIC 
NETWORK UIC 

POINTER TO AUXILARY MONITOR POOL NODE 
POINTER TO SPM NODE IN ICB POOL 
SPM MONITOR STATUS WORD 



EXTERNAL TASKS (LOADER, FllACP) CALL THROUGH THESE 
HOOKS. THEY POINT TO THE RETURN IN $GTPKT IF 
SPM IS TURNED OFF, AND SPM INTERCEPTS THEM WHEN IT 
IS ENABLED . 



.IF DF K$$DAS 
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$SPV01 : 
$SPV02: 
$SPV03: 


: .WORD 
: .WORD 
: .WORD 


; 
; 
; 




.IFF ; 


DF K$$DAS 


$SPV01 : 
$SPV02: 
$SPV03: 


:.WORD 
:.WORD 
: .WORD 


$SPVEX ; 
$SPVEX ; 
$SPVEX ; 



SPM VECTOR FOR ACP HOOKPOINT ENTRY 
SPM VECTOR FOR LOADR HOOKPOINT ENTRY 
SPM VECTOR FOR LOADR HOOKPOINT ENTRY 



SPM VECTOR FOR ACP HOOKPOINT ENTRY 
SPM VECTOR FOR LOADR HOOKPOINT ENTRY 
SPM VECTOR FOR LOADR HOOKPOINT ENTRY 



.ENDC ; DF K$$DAS 



$BTTIM HOLDS THE ABSOLUTE TIME OF WHEN THE SYSTEM WAS BOOTED. 
THE TWO WORDS MUST BE CONSECUTIVE. THE LABEL IS ON THE SECOND ONE 
FOR COMPATABILITY WITH $ABTIM 



;HIGH ORDER. WORD OF $BTTIM 

; VALUE OF $ABTIM WHEN SYS BOOTED 



$BTTM2: 


: .WORD 







$BTTIM: 


: .WORD 









.IF DF 


D$$MND 




$DICSR: 


: .WORD 


D$$MND 




$DITCB: 


; .WORD 
.ENDC 









.IF DF 


M$$PRO 




$CKURM: 


: .WORD 
.ENDC 


1 






.BLKW 


1 






.BLKW 


1 




$INTCT: 


:.WORD 


-1 




$FRKHD: 


:.WORD 









.WORD 


$FRKHD 




$FMASK: 


: .WORD 


FMASK 




$FMSK2: 




.WORD 


F2MASK 


$FMSK3: 




-WORD 


F3MASK 


$FMSK4: 




.WORD 


F4MASK 


$FMSK5: 




.WORD 


F5MASK 


$FMEND: 










.IF DF C$$RMT 




IFMSKR: 


: .WORD 


FMASKR 






.IFF ; 


C$$RMT 




$FMSKR: 










.ENDC 


C$$RMT 




$PRMOD: 


: .WORD 







$CLKHD : 


:.WORD 







$COPT:: 


.WORD 


.COO 




$PARHD: 


:.WORD 







$LDRPT: 


:.WORD 







$TSKHD: 


:.WORD 


$ACTHD 




$CBDHD : 


:.WORD 








; ADDRESS OF DIAMOND REGISTER 

; ADDRESS OF TCB FOR TASK BEING WATCHED 



;URM OF PROCESSOR THAT KEEPS CLOCK 



CLOCK INTERRUPT FORK BLOCK LINK 

CLOCK INTERRUPT FORK BLOCK PC 

CLOCK INTERRUPT TICKS COUNT 

FORK QUEUE LISTHEAD 

(LAST POINTS TO FIRST INITIALLY) 

SYSTEM FEATURE MASK 

SECOND WORD OF SYSTEM FEATURE MASK 

THIRD WORD OF SYSTEM FEATURE MASK 

FOURTH WORD OF SYSTEM FEATURE MASK 

FIFTH WORD OF SYSTEM FEATURE MASK 

REF. LABLE DELIMITING FEATURE MSK WDS 



THIS WORD BECOMES $FMSK5 IF HF.RMT IS SET 



KLNOll 
KLNOll 
KLNOll 
KLNOll 
KLNOll 
KLNOll 
KLNOll 
KLNOll 
KLNOll 



PROCESSOR MODEL NUMBER 

CLOCK QUEUE 

POINTER TO COMMAND OUTPUT UCB 

POINTER TO PARTITION LIST 

POINTER TO LOADER TCB 

POINTER TO SYSTEM TASK DIRECTORY 

COMMON BLOCK DIRECTORY LISTHEAD 
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$GGEF : 
$GFTCB 
$GEFPT 



$LDPCB 
$VECTR 
$MXEXT 
$AVRHD 
$PRIFR 
$ULDPT 
$GNLST 
$PTCBL 
$PTGPT 
$PASTH 



.IF DF G$$GEF 

.WORD 

.WORD $GEFPT+2 

.WORD $GEFPT+2 

.WORD 



.ENDC 

.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 



: DF G$$GEF 



V$$CTR-4 

177777 













0..-2 



GROUP GLOBAL EVENT FLAGS 
GRP GLOBAL USER TCB POINTER 
GROUP GLOBAL MASK ADDRESS POINTER 
DUMMY WORD FOR NON-GRP GLOBAL USE 



CURRENT LOADER PCB POINTER 
HIGHEST VECTOR ADDRESS 
INITIALLY NO LIMIT FOR TASK EXTENSION 
AUTOMATIC VOLUME RECOGNITION LISTHEAD 
CURRENT AMOUNT OF FREE POOL 
MICROCODE LOADER TASK TCB ADDRESS 
GENERAL USE POOL PACKET LISTHEAD 
PROTOTYPE TCB LISTHEAD 
KISAR5 BIAS OF PROTOTYPE TCB 
PARTITION AST LISTHEAD 



P/OS $NXTSK LOCK AND BASE FROM WHICH TO START SEARCH 



$NXTLK::.WORD 
$NXTBA::.WORD 



;$NXTSK RECURSION LOCK 
;$NXTSK BASE SEARCH BIAS 



LOGICAL NAME TRANSLATION SUPPORT DATA 



.IF DF L$$GCL 



$LOGTB::.WORD 
.WORD 

$USRLG::.WORD 
.WORD 
.WORD 

.IFF 
$LOGTB : : 
$USRLG:: 



APR BIAS PTR TO SYSTEM LOGICAL HASH TABLE 
APR BIAS PTR TO GROUP LOGICAL HASH TABLE 
APR BIAS PTR TO USER LOGICAL HASH TABLE 
APR BIAS PTR TO TASK LOGICAL HASH TABLE 
RESERVED WORD FOR P/OS LT.USR (ALWAYS 0) 



DF L$$GCL 



.ENDC : DF L$$GCL 



NAMED DIRECTORY CONTEXT BLOCK POINTER 



$CTXPT : 



.IF DF N$$DIR 

.WORD 

.ENDC ;DF N$$DIR 



THE FOLLOWING WORDS ARE USED FOR THE POOL MONITOR INTERFACE. 

THE ORDERING OF THESE WORDS CANNOT BE CHANGED BECAUSE PMT AND VMR 

ARE WRITTEN TO DEPEND ON IT. 



.IF DF P$$CTL 
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$PTTCB 


; -WORD 





$PRISZ 


: .WORD 





$POLST 


: .WORD 





$PRIHL 


: .WORD 


P$$HIL 


$PRILL 


:.WORD 


P$$LOL 


$PFRSZ 


:.WORD 


P$$FRS 


$POLBP 


r.WORD 


P$$BPR 


$POLFL 


:.WORD 
.IFF 


', 


$PTTCB 






$PRISZ 






$POLST 






$PRIHL 






$PRILL 






$PFRSZ 






$POLBP 






$POLFL 


.ENDC 




; SHADC 


)W RECORDING IMPURE DATA AB 


$SHUMB 


: .WORD 


; 


$SHERR 


:.WORD 


; 


$SHLIM 


:.WORD 


10. ; 


$SHPCT 


:.WORD 


; 


$SHLOS 


:.WORD 


; 


$RCTPT 


:.WORD 


; 


$EXCRC 


:.WORD 


; 



TOB ADDRESS OF POOL RECOVERY TASK 
TOTAL SIZE OF FREE POOL 
EXEC/POOL TASK COMMUNICATIONS WORD 
HIGH WATER MARK FDR POOL MONITORING 
LOW WATER MARK FOR POOL MONITORING 
MINIMUM SIZE OF LARGEST FRAGMENT 
MINIMUM PRIORITY OF NONPRIVILEGED 
TASKS TO EXECUTE DURING LOW POOL 
EXECUTIVE POOL USAGE CONTROL FLAGS 



ALWAYS DEFINE THESE LABELS 



ROOT FOR UMB LIST 

POINTS TO TCB OF SHADOW ERROR TASK 

ERROR PACKET LIMIT 

CURRENT SHADOW ERROR COUNT 

NUMBER OF PACKETS LOST FROM SATURATION 

POINTER TO CURRENT RCT. . . TCB 
EXECUTIVE RO CODE CRC16 



WINDOW I/O COUNT FLAG. THE FOLLOWING WORD IS USED BY DREIF. 
lOFIN. AND DEACC IN THE ACP TO DETERMINE WHETHER TO MANAGE 
THE WINDOW I/O COUNT. IF SET TO DV.Fll THE BEHAVIOR IS TO 
MANAGE THE I/O COUNT (NEW) . IF SET TO ZERO THE I/O COUNT IS 
LEFT ALONE AND THE WINDOW MAY BE DEALLOCATED WITH I/O 
PENDING. THIS MAY CAUSE CRASHES LATER. 



$WCFLG::.WORD ; DV.Fll 
.IF DF D$$CHE 

DATA CACHING IMPURE DATA AREA 



; WINDOW I/O COUNT MANAGEMENT FLAG 
;DISK DATA CACHING SUPPORT 



BM387 
BM387 
BM387 
BM387 
BM387 
BM387 
BM387 
BM387 
BM387 
BM387 



$DCPCB::.WORD 



;PCB ADDRESS OF SYSTEM DEFAULT CACHE PAR 



THESE CELLS ARE FILLED IN BY $MPVBN (MDSUB) FOR 
VIRTUAL TO LOGICAL I/O TRANSLATIONS. THIS INFORMATION 
IS USED BY THE CACHER WHEN PROCESSING THE RESULTING 
I/O PACKET. 
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$DCCEL 


: .WORD 





$DCCEB 


: -WORD 


0.0 


$DCNEL 


: .WORD 





$DCNEB 


:.WORD 


0,0 


$DCSTS 


:.WORD 






.ENDC 



CURRENT EXTENT LENGTH 

CURRENT EXTENT BASE LBN 

NEXT EXTENT LENGTH 

NEXT EXTENT BASE LBN 

STATUS INFORMATION FROM WINDOW BLOCK 

D$$CHE 



;JRK332 



POINTER TO FIRST IPll UCB, USED BY IPll POWERFAIL CODE (IN POWER) 
$IPUCB::.WQRD ; POINTER TO FIRST IPll UCB 



PARAMETER AREA FOR STATUS CHANGE ROUTINES IN OLRSR.MAC 



$SCDEV 
$SCRET 
$SCCTB 
$SCOFL 
$SCERR 



:.BLKW 1 

: .BLKW 1 

:.BLKB 1 

:.BLKB 1 



UCB OR KRB FOR STATUS CHANGE 
REFERENCE LABEL (ALIAS FOR $SCCTB) 
CTB IF ISCDEV CONTAINS KRB 
ONLINE OR OFFLINE PARAMETER 
ERROR RETURN FROM DRIVER 



EVENT TRACE READ/WRITE DATA AREA 





.IF DF 


E$$VNT 


• CURRENT BUFFER INFOR 


$EVKS6 


:.WORD 





$EVDIS 


:.WDRD 





$EVLEN 


r.WORD 





$EVSEQ 


:.WORD 





$EVLOS 


:.WORD 





$EVTCB 


:.WORD 






KISAR6 OFFSET TO BUFFER 

BUFFER POSITION FOR NEXT EVENT 

PTR TO WORD BEYOND END OF BUFFER 

EVENT SEQUENCE NUMBER 

NUMBER OF EVENTS LOST THROUGH SATURATION 

TCB ADDRESS OF EVENT LOGGER TASK 



EVENT SWITCH TABLE 

INDEXED BY EVENT NUMBER 

IF BYTE NEGATIVE, EVENT DISABLED 

IF BYTE POSITIVE, VALUE IS LENGTH OF EVENT 

EVERY EVENT MUST CONTAIN AN ENTRY IN THIS TABLE, OF THE FORM: 

.BYTE -EV.XXX ;THIS IS A SAMPLE EVENT 

WHERE XXX IS THE NUMBER OF THE EVENT. 



$EVTAB:: 



.REPT E$$VNT 

.BYTE -1 
.ENDR 

.BYTE 



; REFERENCE LABEL 

;SET ALL EVENTS TO NULL INITIALLY 
; THERE IS NO EVENT ZERO 
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.EVEN 



EVENT BUFFER MANAGEMENT 



$EV6Sq::.W0RD 1 
$EVLST : : 



$EVKS6 
$EVDIS 
$EVLEN 
$EVSEQ 
$EVTAB 
$EVBSQ 
$EVLST 



.REPT 
.WORD 
.ENDR 
.IFF 



E$$BUF+1 




; BUFFER SEQUENCE NUMBER (NEVER = 0) 
; REFERENCE LABEL 



:KISAR6 POINTER TO BUFFER 



; REFERENCE LABEL 



.ENDC 



; WATCHPOINT DEBUG INFO 


.IF DF R$$WPT 


$WPLST::.WORD 
$WPVAL:: .WORD 
IWPADR:: .WORD 


; 

: 

$WPVAL ; 


.ENDC 


; DF R$$WPT 



LAST SYSTEM STATE ROUTINE CALLED 
VALUE TO WATCH FOR OR AGAINST 
PLACE TO WATCH FOR IT 



ADDITIONAL ARGUMENT TO $POWER FOR MULTIPROCESSOR SYSTEMS. 



.IF DF M$$PRO 
$PFURM::.WORD 
.ENDC 



$SWR: 



.WORD 



:URM TO POWERFAIL 



: SOFTWARE SWITCH REGISTER IF NONE IN HARDWARE 



EXECUTIVE COMMON APR TABLE 

*** NOTE *** 

THIS TABLE IS ORDER DEPENDENT, SINCE THERE IS A TABLE IN VMR OF THE 
STANDARD COMMON NAMES THAT OCCUR IN THE DIRECTIVE PARTITION. A SIDE 
EFFECT OF THIS IS THAT THE ENTRIES BELOW MAY NOT BE CONDITIONALIZED 



LBM050 
LBM050 
LBM050 
**-"5 



.IF DF D$$PAR 
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$DRAPR 


: .WORD 





$DRAP2 


: .WORD 





$DRAP3 


: .WORD 





$DRAP4 


: .WORD 





$DRAPV 


: .WORD 





$DRCHE 


: .WORD 







.WORD 


-1 



APR VALUE TO MAP DIRECTIVE PARTITION 
BIAS OF SECOND DIRECTIVE COMMON 
BIAS OF THIRD DIRECTIVE COMMON 
BIAS OF FOURTH DIRECTIVE COMMON 
BIAS OF EXEC VECTORING DIRECTIVE 
BIAS OF DATA CACHE MANAGER COMMON 
FLAG FOR END OF COMMON BIAS TABLE 



.IFF 



$DRAPR:: 



.ENDC 



; ALWAYS DEFINE THIS SYMBOL 



$ENVEC - TABLE OF ENTRY POINTS FOR VECTORING CODE WHICH CAN'T 
USE $DRGIN 

THIS TABLE CONTAINS A *SMALL* NUMBER OF ADDRESSES AND IS 
INTENDED TO PROVIDE THE MINIMUM AMOUNT OF INFO TO ACCESS THEN 
SYSTEM WITHOUT BEING LINKED TO IT. 



$ENVEC::.WORD $DRAPV 



; POINTER TO APR BIAS OF VECTORING 
; COMMON 





.IF DF C$$CDA 


$CRKRB 

$CRSFM 
$CRSUN 


: .WORD 
: .WORD 
: .WORD 


: 
; 
C$$RUN ; 


$CRCSR 
$CRLCK 


: .WORD 

; .BYTE 

.BYTE 


; 

1 ; 

; 




.ENDC 


; DF C$$CDA 




.IF DF 


R$$NDC 


$RNDCT 
$RNDC: 
$RNDL: 
$RNDH: 


: .WORD 
.WORD 
.BYTE 
.BYTE 


R$$NDC : 
R$$NDC ; 
R$$NDL ; 
R$$NDH ; 



CRASH DUMP DEVICE KRB ADDRESS 

CRASH FORMATTER NUMBER (RH TAPE ONLY) 

CRASH PHSICAL UNIT NUMBER. NOTE: C$$RUN IS 

. . .A LOGICAL UNIT NUMBER. INITL CONVERTS 

. . .$CRSUN TO A PHYSICAL UNIT NUMBER. 

CRASH DEVICE CSR ADDRESS WHEN NO KRB 

ONLY ONE CPU SHOULD DUMP MEMORY 

PRESERVE WORD ALIGNMENT 



CLOCK TICKS TO NEXT SCHEDULE INTERVAL 
CLOCK TICKS PER SCHEDULING INTERVAL 
LOWEST PRIORITY CLASS TO CONSIDER 
HIGHEST PRIORITY CLASS 



.ENDC 



$SWPCT 
$SWPC: 
$SWPR: 



.IF DF S$$WPC&D$$ISK 

.WORD S$$WPC 

.WORD S$$WPC 

.WORD S$$WPR 

.ENDC 



CLOCK TICKS TO NEXT SWAPPING INTERVAL 
CLOCK TICKS PER SWAPPING INTERVAL 
SWAPPING PRIORITY 



DAYS PER MONTH TABLE (ENTRY CONTAINS DAYS PER MONTH + 1) 
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$DYPMN::.BYTE 


29. 


,32. 


FEBRUARY, MARCH 


.BYTE 


31. 


,32. 


APRIL, MAY 


.BYTE 


31. 


,32. 


JUNE, JULY 


.BYTE 


32. 


.31. 


AUGUST. SEPTEMBER 


.BYTE 


32. 


,31. 


OCTOBER, NOVEMBER 


.BYTE 


32. 


.32. 


DECEMBER, JANUARY 


; BIT MASK TABLE 







NOTE: 



$BTMSK: 



DUE TO THE ORGANIZATION OF THE SUPERVISOR MODE MAPPING CONTROL 
SUPPORT, NAMELY THE FACT THAT BIT OF THE BYTE CORRESPONDS TO 
APR 1, NOT APR 0, THERE MUST BE A ZERO PRECEDING $BTMSK. 



.WORD 





DUMMY FO 


R APRO BITMASK 


.WORD 


1 


BIT 0. 




.WORD 


2 


BIT 1. 




.WORD 


4 


BIT 2. 




.WORD 


10 


BIT 3. 




.WORD 


20 


BIT 4. 




.WORD 


40 


BIT 5. 




.WORD 


100 


BIT 6. 




.WORD 


200 


BIT 7. 




.WORD 


400 


BIT 8. 




.WORD 


1000 


BIT 9. 




.WORD 


2000 


BIT 10. 




.WORD 


4000 


BIT 11. 




.WORD 


10000 


BIT 12. 




.WORD 


20000 


BIT 13. 




.WORD 


40000 


BIT 14. 




.WORD 


100000 


BIT 15. 





BIT MASK TABLE FOR FORMING ADDRESS MASKS IN $ACHRO IN 
USER I/D SYSTEMS 

.IF DF U$$DAS!S$$LIB 



.BYTE 
$BCMSK: :.BYTE 



$APRTB: 



1,3,7,17,37.77,177,377 
.ENDC ; DF U$$DAS ! S$$LIB 
TABLE OF APR ADDRESSES USED BY GIN SF.APR FUNCTION 



: KERNEL I SPACE REGISTERS 



.WORD 


KINARO.KINDRO 


.IF DF 


K$$DAS 


.WORD 


KDSARO.KDSDRO 


.ENDC 


; DF K$$DAS 


.WORD 


UINARO.UINDRO 


.IF DF 


U$$DAS 


.WORD 


UDSARO.UDSDRO 


.ENDC 


; DF U$$DAS 


.IF DF 


S$$LIB 



; KERNEL D SPACE REGISTERS 



lUSER I SPACE REGISTERS 



;USER D SPACE REGISTERS 
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.WORD 
.WORD 



SISARO.SISDRO 
SDSARO.SDSDRO 



.ENDC ; DF S$$LIB 
.WORD 



; SUPER I SPACE REGISTERS 
; SUPER D SPACE REGISTERS 



;END OF TABLE 



SHUFFLER TASK REQUEST LIMIT FLAGS. $SHFTM CONTAINS THE NUMBER 
OF CLOCK TICKS THAT MUST EXPIRE BEFORE THE SHUFFLER TASK CAN 
BE REQUESTED BY THE EXECUTIVE. IT IS INITIALIZED TO THE VALUE 
CONTAINED IN $SHFCT EACH TIME THE SHUFFLER EXECUTES. 



$SHFTM:: .WORD 
$SHFCT:: .WORD S$$HFC 



;TIME REMAINING BEFORE NEXT POSSIBLE REQUEST 
; MINIMUM TICKS BETWEEN SHUFFLER REQUESTS 



ONLINE ERROR LOGGING DATA BASE 



.IF DF E$$LOG 





ERROR 


LOG FEATURE 


EFEAT = 









.IIF 


DF,E$$ICM 




.IIF 


DF,E$$MOU 




.IIF 


DF,E$$SEF 


$EFMSK: 


:.WORD 


EFEAT 


$ERHEA: 


:.WORD 


0. .-2 


$ENTSQ: 


:.WORD 





$ERFLA: 


:.WORD 





$ERRX:: 


.WORD 






.IFF 



$ERFLA: : 



EFEAT = EFEAT ! EL. ICM 
EFEAT = EFEAT! EL. MOU 
EFEAT = EFEAT! EL, SEF 
SELECTED FEATURE MASK WORDS 

MESSAGE QUEUE LISTHEAD 

ENTRY SEQUENCE NUMBER 

ERROR LOGGER FLAG WORD 

POINTER TO SECONDARY POOL ERRLOG DATA 



; REFERENCE LABEL 



.ENDC : DF E$$LOG 



$ERRPT: : .WORD 
$ERRSQ::.WORD 



; POINTER TO ERROR LOGGER TCB 
: ERROR SEQUENCE NUMBER 



$NCTPT: : 



.IF DF T$$TSA 

.WORD 

.WORD 

.WORD 

.ENDC : T$$TSA 



APR BIAS OF NT.NCT 

APRS ADDRESS OF QUEUE ROUTINE 

NCT... TCB ADDRESS 



.IF DF R$$PRO 
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$NVRTM CONTAINS THE NUMBER OF TICKS THAT MUST ELAPSE BEFORE THE 
0/S UPTIME CELL IN THE PROFESSIONAL 3XX NVR IS UPDATED. IN GENERAL 
IT IS SET TO THE NUMBER OF TICKS PER SECOND TIMES 60. THIS RESULTS 
IN UPTIME IN MINUTES BEING RECORDED. IT IS INITIALIZED WITH $NVRCT 
EACH TIME THAT NVR IS UPDATED. 



$NVRTM::.WORD 
$NVRCT::.WORD N$$VRC 



; TICKS TILL NEXT NVR UPDATE 
; TICKS PER NVR UPDATE CYCLE 



TASK NAME OF THE P/OS DISPATCHER. 
USED TO SEND MESSAGES AND AST'S TO IT. 



$CTBNM : : . RAD50 /C$CTEX/ 



;NAME OF THE P/OS DISPATCHER 



.ENDC ; DF R$$PRO 
$DVSAV::.BLKW 1 



; SAVED CSR CONTENTS 



SYSTEM BOOTSTRAP AND SAVE CONFIGURATION VECTOR 



$SYALT: 



.IF NDF K$$DAS 



.ENDC 



: REFERENCE LABEL 



$SYSIZ::.WORD S$$YSZ 

.BLKB 1 

.BLKB 3 

.BLKW 1 

.6LKW 1 



SIZE OF MEMORY IN 32W BLOCKS 
LOGICAL UNIT NUMBER OF LOAD DEVICE 
LBN OF LOAD/SAVE IMAGE ON DISK 
NAME OF LOAD DEVICE IN ASCII 
SIZE OF LOAD IMAGE IN 256W BLOCKS 



TIME LIMIT PARAMETERS 



YEARS PER UNIVERSE 

MONTHS PER YEAR 

DAYS PER MONTH (CALCULATED) 

HOURS PER DAY 

MINUTES PER HOUR 

SECONDS PER MINUTE 



ACCOUNTING USES $ACTPS TO GET THE NUMBER OF CLOCK TICKS PER SECOND. 
ON SYSTEMS WHERE ACCOUNTING IS USING THE SYSTEM CLOCK, $ACTPS MUST 
REFERENCE THE SAME WORD AS $TKPS. IF ACCOUNTING HAS ITS OWN CLOCK. 
IT WILL CONTAIN THE TICK RATE OF THAT CLOCK. 



WORD 


-1 


WORD 


13. 


WORD 


32. 


WORD 


24. 


WORD 


60. 


WORD 


60. 



$ACTPS: 



; CLOCK RATE FOR ACCOUNTING 



.IF EQ K$$CSR- 177546 
$TKPS:: .WORD H$$RTZ 
.IFF 



; TICKS PER SECOND 
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$TKPS:: .WORD 


K$$TPS 


.ENDC 




■ CURRENT TIME VECTOR 


.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
.WORD 
$TTNS:: .WORD 


82. 

3. 

30. 










.IF DF 


P$$3XX 


$CKCSA::.WORD 


$CKCSA 



; TICKS PER SECOND 



YEAR OF UNIVERSE - HAPPY 30TH 
MONTH OF YEAR - BIRTHDAY 
DAY OF MONTH - MS. LAWLER 
HOUR OF DAY 
MINUTE OF HOUR 
SECOND OF MINUTE 
TICK OF SECOND 



THIS WORD IS SET EITHER TO POINT 
TO ITSELF (PDP-11 HARDWARE) OR 
TO THE CLOCK CSR (SAME AS $CKCSR) 
(PRO HARDWARE) TO MAKE TDSCH CLOCK 
TICKLING RUN TIME CONDITIONAL 



.ENDC 



DF P$$3XX 



LIFO SEND AND I/O PREALLOCATION LIST POINTER AND PARAMETERS 





.IF DF 


Q$$OPT 


IPKAVL: 
$PKNUM: 
$PKMAX: 


.WORD 
-BYTE 
.BYTE 

.IFF 




q$$OPT 


$PKHUM: 
$PKMAX: 







POINTER TO FIRST PACKET IN LIST 
NUMBER OF PACKETS CURRENTLY IN LIST 
MAXIMUM NUMBER ALLOWED IN LIST 



;REF LABEL FOR MCR 
;REF LABEL FOR MCR 



.ENDC 



SAVE AREA FOR CALCULATED MULTI-USER TASK NAMES. 



.IF DF R$$DSP 
$TNAME::.BLKW 2 
.ENDC 



; (2ND WORD IS ALSO FLAG FOR RQST tc RUN) 



TEMPORARY STORAGE VARIABLES FOR DIRECTIVE SERVICES 
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$TEMPO 


:.BLKW 


1 


$TEMP1 


:.BLKW 


1 


$TEMP2 


:.BLKW 


1 


$TEMP3 


:.WORD 





$TEMP4 


:.WORD 





$TONYL 


: .WORD 





$IOTMP 


: .WORD 





$ATTPT 


: .WORD 





$CTLST 


: .WORD 


$CTBO 



COMPLETION ROUTINE ADDR FOR $GSPKT 
SCRATCH SPACE FOR SPWN$ AND RPOI$ 
SCRATCH SPACE FOR SPWN$ AND RPOI$ 
SCRATCH STORAGE FOR SEEK OPTIMIZATION 
SCRATCH WD FOR ADDR CHECKING AND 
ACP QIO TEMPORARY WORK 
POINTER TO I.AADA IN CURRENT PACKET 

START OF THE CTB LIST 



KERNEL AST DISPATCH TABLE 

THIS TABLE IS FILLED IN BY INITL AT BOOT TIME. ANY CHANGES MADE 
HERE MUST BE REFLECTED IN INITL AT DBTBL. 

IF THE SYSTEM DOES NOT SUPPORT KERNEL I/D SPACE, THEN THE REFERENCES 
ARE RESOLVED DIRECTLY. 



$KATBL::.WORD $FINBF 

.WORD $FINXT 

.WORD $GENBF 

.WORD $DBTRP 

.WORD $FINDI 

.IF DF G$$GEF 

.WORD $GGFRN 

.IFF ; DF G$$GEF 

; .WORD 

.ENDC : DF G$$GEF 

.IF DF M$$PRO 

$URMST::.WORD 



$FINBF-BUFF I/O FINISH (AK.BUF) 

$FINXT-OFF. TASK EXIT (AK.OCB) 

$GENBF-GEN. BUFF. I/O (AK.GBI) 

$DBTRP-FORCE T-BIT TRAP (AK.TBT) 

$FINBF-DELAYED I/O FIN (AK.DIO) 



;$GGFRN-GROUP GBL RUNDWN (AK.GGF) 



;IF OTHER KASTS ARE INVENTED, MAKE 
;THIS A PLACEHOLDER IN THE TABLE. 



lUNIBUS RUN MASK STATUS TABLE 



.IF DF X$$DBT 

$XDTFL::.WORD 1 
$XDTPR::.WORD 



.IFF 

$XDTFL::.WORD 
$XDTPR:: 



.ENDC 



177777 



;XDT INITIALIZATION TABLE 
;FLAG FOR PROMPTS OF XDT 



ALWAYS LOOKS INITIALIZED WHEN NOT THERE 
REFERENCE LABEL — UNUSED IF XDT ALREADY 
INITIALIZED 



0FF=177777 

.REPT 

OFF=OFF+OFF 

.ENDR 



M$$PRO 
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PROCESSOR BIT CLEAR UkSK 

IIST INTERRUPT MASK WORD 

PENDING URM WORK WORD. LOCKED WITH $FORKL 

MASK OF URMS THAT HAVE BEEN INTERRUPTED 

ROUND ROBIN WORD FOR $IISVC 

SANITY TIMER ENABLED ON VARIOUS CPU'S 

SECONDARY SANITY TIMER FLAG 

SANITY TIMER ALARM ENABLED ON CPU'S 

MASK OF CPUS IN THEIR POWERFAIL CODE 

POINTER TO PARTITION FOR CPU LOCAL MEM 

NOTE THAT THE NEXT TWO TABLES FOLLOW AN INDEX STRUCTURE LIKE THAT 
OF $PARTB+2 INS LOWCR. AND THE TWO SHOULD BE UPDATED IN HARMONY WITH 
HRC (MODULE HRBOX) 



$CPMSK 


r.WORD 


OFF 


$IIMSK 


: .WORD 





$IIPMD 


: -WORD 





$IICPU 


:.WORD 





$IINXT 


:.WORD 


$BTMSK 


$STENB 


:.WORD 





$STFLG 


: -WORD 





$STALR 


: .WORD 





$PWRMK 


: .WORD 





ICPPAR 


: .WORD 






.IF DF M$$K11 



$MKCS1::.W0RD 

.WORD 

$MKCSR::.BLKW 

$MKCS2::.BLKW 



1 

8. 
8. 
8. 



CONTENTS FOR CSR 1 OF MKll'S 
NUMBER OF MKll'S POSSIBLE 
CSR ADDRESS TABLE FOR MKll PARITY 
CSR CONTENTS FOR MKll'S 



.ENDC ; DF M$$K11 



MULTIPROCESSOR LOCKS 

BYTE 0— LOCK VALUE (0 IF LOCKED, 1 IF FREE) 
BYTE 1 —IF BYTE EQUALS: 

0. THEN BYTE 1 EQUALS PROCESSOR ID OF OWNER 

1. THEN BYTE 1 EQUALS COMPLEMENT OF ID OF 
PREVIOUS OWNER 

IF LOCK TYPE IS "WAIT" THEN: 

BYTE 2,3 = SECONDARY LOCK WORD (ABOVE FORMAT) FOR WAIT MASK. 
BYTE 4,5 = MASK OF WAITING PROCESSORS. 

NOTE: BYTES 4+5 ARE REFERENCED AS A WORD. 



$EXECL::LCKDF$ WAIT 

$FORKL::LCKDF$ SPIN 

$IIFNL::LCKDF$ SPIN 

$PWRLK::LCKDF$ SPIN 

MULTIPROCESSOR TABLE 



$TKTAB : : 



.REPT M$$PRO 
.WORD $ACTHD 
.ENDR 



.IFTF 
$RQTAB:;.WORD 
.IFT 



$ACTHD 



SERIALIZE ACCESS TO EXECUTIVE DATA 
SERIALIZE ACCESS TO FORK LIST 
SERIALIZE ACCESS TO $MPTAB 
SERIALIZE ACCESS TO $PWRMK 



; CURRENT TASK TCB TABLE 

; INITIALIZE TO NUU TASK TCB 

; RESCHEDULE POINTER TCB TABLE 
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.REPT 


M$$PR0-1 




.WORD 


$ACTHD 




.ENDR 






.IFTF 




IPRTAB:: 


; .WORD 







.IFT 






.REPT 


M$$PR0-1 




.WORD 







.ENDR 




$MPTAB:: 








.REPT 


M$$PR0 




.WORD 


MP . STP 




.ENDR 




0FF=O 






$K6TAB: 








.REPT 


M$$PRO 




.WORD 


OFF 


OFF=0FF+4O 






.ENDR 




0FF=1 






$URMTB: 








.REPT 


M$$PRO 




.WORD 


OFF 


OFF=OFF+OFF 






.ENDR 




0FF=1 






$CRMtB : 








.REPT 


M$$PRO 




.WORD 


•"C<OFF> 


OFF=OFF+OFF 






.ENDR 






.IFTF 




$CRFLG: 


:.WORD 
.IFT 







.REPT 


M$$PR0-1 




.WORD 







.ENDR 




$CRFPR: 


:.WORD 
.IFT 


377 




.WORD 


1 




.IFTF 






.BLKW 


2 



; INITIALIZE TO NULL TASK TCB 

; PROCESSOR CURRENT TASK PRIORITY TABLE 

; INITIALIZE TO PRIORITY ZERO 

; PROCESSOR STATUS TABLE 
{INITIALLY STOPPED 



: START K6 OFFSETS AT ZERO 

; PROCESSOR IMPURE AREA APR OFFSETS 



; INCREASE OFFSET BY IK 

; START PROCESSOR URMS AT 1 

; PROCESSOR URM CONNECTIVITY TABLE 

;POOR MAN'S LEFT SHIFT 



; START PROCESSOR URMS AT 1 

; COMPLEMENT OF CPU URM CONNECTIVITY TBL 



;POOR MAN'S LEFT SHIFT 



;FLAG INDICATING REGISTERS HAVE BEEN SAVED 



$PBEZ: 



;$PROCN OF FIRST PROCESSOR TO CRASH 



;URM IN FORK BLOCK FOR ERRLOG 



; ERROR LOGGING FORK BLOCK 
: REFERENCE LABEL 



.IFT 
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URM=2 



.REFT 
.WORD 
URM=URM*2 

.BLKW 
.ENDR 


M$$PR0-1 
URM 

3 


;URM IN FORK BLOCK 
:3 WORD FORK BLOCK 


.ENDC 






.IF DF 


F$$LPP 




.IF DF 


M$$PR0 




.WORD 


1 


;URM IN FORK BLOCK 


.IFTF 






.BLKW 


2 


;2 WORD FORK BLOCK 



$FLFTB : : 



URM=2 



.IFT 

.REPT M$$PR0-1 
.WORD URM 



URM=URM*2 

.BLKW 
.ENDR 

.ENDC 

.ENDC 



; REFERENCE LABEL 



DEFINITIONS FOR NON MKll MEMORY SYSTEMS 
.IF NDF M$$K11 



$MKCS1 : 

$MKCSR:: 
$MKCS2 : : 



.WORD 

.ENDC ; DF M$$K11 
.IF NDF M$$PRO 



;# OF MKll REGISTERS (FOR BOO.SAV.HRC) 
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DEFINITIONS FOR NON-MULTIPROCESSOR SYSTEMS 



$CKORM 
$CPBIT 
$CPCRM 
$CPMSK 
$CPURM 
$CPUSC 
$CRMTB 
$EXECL 
$IBXMT 
$IIMSK 
$IISTM 
$IIXMT 
$MPTAB 
$PROCN 
$PR0C2 
$PFURM 
$STENB 
$STFLG 
$STALR 
$TKTAB 
$imMST 
$URMTB 
$XDTFL 
$XDTPR 
$XDTIN 



; REFERENCE LABELS 

; COMPLEMENTED RUN MASK 



;CPU STATUS CHANGE ENTRY 

; COMPLEMENTED RUN MASK TABLE 

;IIST INTERCPU BOOT TRANSMIT 

:IIST SUBROUTINE ENTRY POINT 
;IIST TRANSMIT SUBROUTINE 



; SANITY TIMER ENABLE 



;**-! 



.ENDC 



HERE WE DEFINE A SINGLE "FAKE WORD" WHICH RECEIVES ALL THE ADDRESSES 
FOR THINGS WHICH ARE NOT GENNED INTO THE SYSTEM, BUT WHICH REQUIRE 
THAT THE ADDRESSES ALWAYS BE RESOLVED FOR TASKBUILDING MCR, ETC. 
THIS ONE (IN SYSCM) IS TO BE USED FOR D SPACE LOCATIONS. AND THE 
ONE IN LOWCR IS USED FOR I SPACE REFERENCES AND CPU SPECIFIC INFO 
(ALSO THINGS WHICH MUST BE ACCESSED WHEN D SPACE IS TURNED OFF) 



$WPVAL 
$WPADD 
$WPLST 



.IF NDF R$$WPT 



FAKE = 
.ENDC : 



NDF R$$WPT 



.IF NDF E$$LOG 



SERHEA:: 
$ENTSq : : 



FAKE = 

.ENDC ; NDF E$$LOG 

.IF DF FAKE 

.WORD -1 



;FAKE DATA LOCATION FOR ALL OF THE 
; ABOVE 
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.ENDC ; DF FAKE 





.IF DF 


P$$OOL 


$PLPAR: 
$POLHD: 
$SECFR: 


: .WORD 
: .WORD 
: .WORD 

.IFF 


; 
; 
; 


$PLPAR: 
$POI.Hn: 
$SECFR: 


.ENDC 






.IF DF 


A$$CNT 


$SYLHD: 
$SABPT: 


:.WORD 

.WORD 

:.WORD 


; 
$SyLHD ; 
: 




.IF DF 


X$$ACC 


$ACNFE: 


: .WORD 


BF.TRNIBF.XAC ; 




.IFF 


;X$$ACC 


$ACNFE: 


: .WORD 


BF.TRN ; 




.ENDC 


;X$$ACC 


$APLIM: 
SSYUAB : 
$CKUAB: 


: .WORD 
: .WORD 
: .WORD 

.IFF 


; 
; 
; 


ISABPT: 
$SYLHD: 
lACNFE: 
$APLIM: 
$SYUAB: 


-IFTF 




$LOGPT: 


:.WORD 


: 



POINTER TO SECONDARY POOL PCB 

LIST HEAD FOR SECONDARY POOL FREE LIST 

NUMBER OF FREE BLOCKS IN SECONDARY POOL 



LISTHEAD FDR SYSLOG INPUT QUEUE 

END OF LIST POINTER 

POINTER TO SYSTEM ACCOUNT BLOCK 



EXTENDED ACCOUNTING 



NORMAL SUPPORTED ACCOUNTING 



FREE SEC POOL SPACE ACNT MUST RESERVE 
ADDRESS OF UAB FOR SYSTEM TASKS 
UAB FOR TASK RUN FROM CLOCK QUEUE 



POINTER TO TCB OF SYSLOG TASK 



.ENDC 



; CLI DATABASE AREA 



$CLICQ::.WORD 
.WORD 

$CNTLN:: .WORD 
.WORD 





$CLICQ 



$CNTLN 



$CPTBL::.WORD $MCRPT 
.IF DF A$$CLI 
.REPT A$$CLI-1 



; COMMAND QUEUE LISTHEAD 

; CONTINUATION LINE SEGMENT LISTHEAD 

; POINTER TO CPB FOR MCR 
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.WORD 





.ENDR 




$NMCLI==A$$CLI 




. IF'i'K 


;A$$CLI 


; CPE FOR MCR 




IMCRPT: : .WORD 
.RAD50 
.WORD 
.BYTE 
.BYTE 

$$$=. 




/MCR / 

CP.LGO 

MDPL 

MCPL 


.IF DF R$$MIC 


.ASCIZ 


<15><12>/$ / 


-IFF 


; DF R$$MIC 


.ASCIZ 


<16><12>/>/ 


.ENDC 


; DF R$$MIC 


MDPL=.-$$$ 




$$$=. 




.IF DF R$$MIC 


.ASCIZ 


<15><12>/DCL>/ 


.IFF 


; DF R$$MIC 


.ASCIZ 


<15><12>/MCR>/ 


.ENDC 


; DF R$$MIC 


MCPL=.-$$$ 




.EVEN 




.IFF 


:A$$CLI 


$NMCLI==0 




.ENDC 


;A$$CLI 



; TABLE FOR CPB ADDRESSES 



; NUMBER OF CLIS SYSTEM SUPPORTS 



POINTER TO MCR'S TCB. START OF MCR'S CPB 

CLI NAME 

STATUS WORD 

LENGTH OF DEFAULT PROMPT STRING 

LENGTH OF CONTROL/C PROMPT STRING 



; MICRO DEFAULT PROMPT 



; DEFAULT PROMPT STRING 



; CONTROL/C PROMPT 



; CONTROL/C PROMPT STRING 



; ALTERNATE CLI NOT SUPPORTED 



$CMFIN:: ; END OF SYSCM AREA FOR CDA 

PARAMETER WORD TO CONTROL TERMINAL DRIVER SYSTEM-WIDE BEHAVIOR: 

BIT * FOR REMOTE LINES, DON'T HANGUP IMMEDIATELY ON CARRIER LOSS 

1 FOR REMOTE LINES. HANGUP IMMEDIATELY ON CARRIER LOSS 

BIT 1 = FOR REMOTE LINES, DON'T ENABLE DTR UNTIL RING IS SEEN 

1 FOR REMOTE LINES. ENABLE DTR BEFORE RING IS SEEN 

$TTPRM::.WORD 2 ; DEFAULT TERMINAL DRIVER BEHAVIOR 

TERMINAL DRIVER DATA BUFFER - NOT DUMPED BY CDA 

.IF DF K$$DASJ!T$$COM 
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$DALED::.BLKW 1 ; TERMINAL DRIVER DATA 

.ENDC ;DF K$$DAS&T$$COM 

.IF DF T$$ACD 

$ACDHD::.WORD ; ANCILLARY CONTROLL DRIVER BLOCK LISTHEAD 

.ENDC ; DF T$$ACD 
.END 
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Appendix C 



System Data Structures and Symbolic Definitions 

This appendix describes the RSX-llM-PLUS and Miao/RSX system macros that supply 
symbolic offsets for data structures listed in Table C-1. 

The data structures are defined by maaos in the Executive macro library. To reference any of 
the data structure offsets from your code, include the macro name in an .MCALL directive and 
invoke the macro. For example: 

.MCALL DCBDF$ 

DCBDF$ ; Define DBC offsets 

Note 
All physical offsets and bit definitions are subject to change in future releases of 
the operating system. Code that accesses system data structures should alwrays 
use the symbolic offsets rather than the physical offsets. 

The first tv^ro arguments, <:> and <=> , make all definitions global. If they are left blank, the 
definitions will be local. 

All of these macros are in the Executive macro library LB:[1,1]EXEMC.MLB. All except 
F11DF$, ITBDF$, MTADF$, OLRDF$, and SHDDF$ are also in the Executive definition library 
LB:[l,l]EXELlB.OLB. 

Table C-1: Summary of System Data Structure Macros 



Macro Arguments Data Structures 

ABODF$ <:> , <-> Task abort and termination notification message codes 

ACNDF$ <:>,<=> Accounting data structures (user account block, task account 

block, system account block) 

CLKDF$ <:> , <=> Clock queue control block 

CTBDF$ <!>,<=> Controller table 

DCBDF$ <:>,<=> Device Control Block 
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Table C-1 (Cont.): Summary of System Data Structure Macros 
Macro Arguments Data Structures 



EPKDF$ <:>,<=> 
EVNDF$ <:>,<-> 
F11DF$ <:>,<-> 

HDRDF$ <:>,<-> 
HWDDF$ <:>,<=> 
ITBDF$ <:>,<=> 
KRBDF$ <:>,<=> 
LCBDF$ <:>,<=> 
LNMDF$ <:>,<=> 
MTADF$ <!>,<-> 
OLRDFS 

FCBDF$ <:>,<=> 
PKTDF$ <:>,<=> 

SCBDF$ <:>,<=> 
SHDDFS <!>,<-> 
TCBDF$ <:>,<=> 
UCBDF$ <:>,<-> JTDEF 



Error message block 

Terminal Software Architecture (TSA) event packet definitions 

FILES- 11 data structures (Volume Control Block, mount list 
entry. File Control Block, file window block, locked block list 
node) 

Task header and window block 

Hardware register addresses and feature mask definitions 

Interrupt transfer block 

Controller request block 

Logical assignment control block 

Logical name block 

ANSI magtape data structures (volume set control block) 

On-line reconfiguration interface 

Partition Control Block and attachment descriptor 

I/O packet, AST control block, offspring control block, group 
global event flag control block, and CLI parser block 

Status Control Block and UMR assignment block 

Shadow recording linkage block 

Task Control Block 

Unit Control Block 
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ABODF$ 



.MACRO ABODF$,L.B 

TASK ABORT CODES 

NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS 



S.CACT= 


B' 


S.CEXT= 


B' 


S.COAD= 


B' 


S.CSGF= 


B' 


S.CBPT= 


B' 


S.CIOT= 


B' 


S.CILI= 


B' 


S . CEMT= 


B' 


S.CTHP= 


B' 


S.CFLT= 


B' 


S.CSST= 


B" 


S.CAST= 


B' 


S.CABO= 


B' 


S.CLRF= 


B' 


S.CCRF= 


B' 


S.IOMG= 


B' 


S.PRTY= 


B' 


S . CPMD= 


B' 


S.CELV= 


B' 


S.CINS= 


B' 


S.CAFF= 


B' 


S.CCSM= 


B' 


S.CUTL= 


B' 


S.CTKN= 


B' 



-4. 

-2. 

0. 

2. 

4. 

6. 

8. 

10. 

12. 

14. 

16. 

18. 

20. 

22. 

24. 

26. 

28. 

30. 

32. 

34. 

36. 

38. 
40. 
42. 



TASK STILL ACTIVE 

TASK EXITED NORMALLY 

ODD ADDRESS AND TRAPS TO 4 

SEGMENT FAULT 

BREAK POINT OR TRACE TRAP 

lOT INSTRUCTION 

ILLEGAL OR RESERVED INSTRUCTION 

NON RSX EMT INSTRUCTION 

TRAP INSTRUCTION 

11/40 FLOATING POINT EXCEPTION 

SST ABORT-BAD STACK 

AST ABORT-BAD STACK 

ABORT VIA DIRECTIVE 

TASK LOAD REQUEST FAILURE 

TASK CHECKPOINT READ FAILURE 

TASK EXIT WITH OUTSTANDING I/O 

TASK MEMORY PARITY ERROR 

TASK ABORTED WITH PMD REQUEST 

TI: VIRTUAL TERMINAL WAS ELIMINATED 

TASK INSTALLED IN 2 DIFFERENT SYSTEMS 

TASK ABORTED DUE TO BAD AFFINITY (REQUIRED BUS 

RUNS ARE OFFLINE OR NOT PRESENT) 

BAD CSM PARAMETERS OR BAD STACK 

TASK HAS RUN OVER ITS TIME LIMIT 

ABORT VIA DIRECTIVE WITH NO TKTN MESSAGE 



TERMINATION CODES FOR BOM$ 

NOTE: 

THE NORMAL TKTN ERROR CODES SPAN -4 THROUGH 42. THE BOM CODES, 
ALTHOUGH DEFINED FOR THE TASK, ETC, AS THROUGH N. ARE PASSED TO 
TKTN AS -127 THROUGH -127+N. AN UNRECOGNIZED CODE IS PASSED AS -128, 
UNKNOWN ERROR. 

*** WARNING *** 



THESE CODES ARE CURRENTLY ALSO DEFINED IN BOM. MAC IN BOMDF$. 
THAT IS CHANGED, KEEP THE TWO SETS OF DEFINITIONS IN SYNC. 



UNTIL 



S.BUNK='B'-128. 

S.BFEI='B'0. 

S.BOVL='B'l. 



UNKNOWN BOM$ ERROR 

ERROR IN HIGH LEVEL LANGUAGE INTERFACE 

LOAD OVERLAY FAILURE 



KEEP THE FOLLOWING DEFINED AS THE HIGHEST CODE IN USE 



S.BHI='B'l. 



; HIGHEST ACCEPTABLE BOM$ CODE 
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ABODF$ 



BIT DEFINITIONS FOR BOM$ FLAGS WORD 



S.BBIF='B'l. 



; ENABLE CONDITIONAL BREAKPOINT 



TASK TERMINATION NOTIFICATION MESSAGE CODES 



T.NDNR= 


B' 


T . NDSE= 


B' 


T.NCWF= 


B' 


T.NCRE= 


B' 


T.NDMO= 


B' 


T.NUER= 


B' 


T.NLDN= 


B' 


T.NLUP= 


B' 


T.NCFI= 


B' 


T.NUDE= 


B' 


T.NMPE= 


B' 


T.NKLF= 


B' 


T.NAAF= 


B' 


T.NTAF= 


B' 


T . NDEB= 


B' 


T.NRCT= 


B' 


T.NWBL= 


B' 


T.NVER= 


B' 


T.NIOS= 


B' 


T.NIOR= 


B' 





2 

4 

6 

8. 

10. 

12. 

14. 

16. 

18. 

20. 

22. 

24. 

26. 

28. 

30. 

32. 

34. 

36. 

38. 

.MACRO 

.ENDM 

.ENDM 



DEVICE NOT READY 

DEVICE SELECT ERROR 

CHECKPOINT WRITE FAILURE 

CARD READER HARDWARE ERROR 

DISMOUNT COMPLETE 

UNRECOVERABLE ERROR 

LINK DOWN (NETWORKS) 

LINK UP (NETWORKS) 

CHECKPOINT FILE INACTIVE 

UNRECOVERABLE DEVICE ERROR 

MEMORY PARITY ERROR 

UCODE LOADER NOT INSTALLED 

ACCOUNTING ALLOCATION FAILURE 

ACCOUTING TAB ALLOCATION FAILURE 

TASK HAS NO DEBUGGING AID 

REPLACEMENT CONTROL TASK NOT INSTALLED 

WRITE BACK CACHING DATA LOST. UNIT WRITE LOCKED 

MOUNT VERIFICATION TASK NOT INSTALLED 

I/O STALLED TO DEVICE 

I/O RESUMING ON DEVICE 



ABODF$ X,Y 
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ACNDF$ 



.MACRO ACNDF$,L,B 

h 

ACCOUNTING BLOCK OFFSET AND STATUS DEFINITIONS 
FOR EACH TRANSACTION TYPE. 

HEADER COMMON TO ALL TRANSACTIONS 
.ASECT 



B.LNK:'L'.BLKW 1 

B.TYP:'L'.BLKB 1 

B.LEN:'L'.BLKB 1 

B.TIM: 'L' .BLKW 3 
B,HID='B'. 

B.UID:'L'.BLKW 2 

B.ACN:'L'.BLKW 1 

B.TID:'L'.BLKB 1 



.BLKB 



B.HEND='B' 
$$$HLN». 



LINK TO NEXT IN SYSLOG QUEUE 

TRANSACTION TYPE 

TRANSACTION LENGTH 

ENDING TIME OF TRANSACTION 

START OF HEADER IDENTIFICATION AREA 

UNIQUE SESSION IDENT 

FIRST W0RD-RAD5O. SECOND-BINARY 
ACCOUNT NUMBER 

ASCII TERMINAL TYPE (V.T.B OR C) 
(VIRTUAL. REAL, BATCH, OR CONSOLE) 
UNIT NUMBER 
END OF HEADER ID AREA 
HEADER LENGTH 



ACCUMULATION FIELDS FOR TAB, UAB, AND SAB 



B.CPU:'L' 
B.DIR:'L' 
B.QIOr'L' 
B.TASr'L' 
B.MEM: 'L' 
B.BEG:'L' 
B.CPUL:'L 
B.PNT:'L' 
B.STM:'L' 
$$$TLN=. 



.BLKW 2 

.BLKW 2 

.BLKW 2 

.BLKW 2 

.BLKW 3 

.BLKW 3 

' .BLKW 2 

.BLKW 1 

.BLKB 1 



TOTAL CPU TIME USED 

TOTAL DIRECTIVE COUNT 

TOTAL QIO$ COUNT 

TOTAL TASK COUNT 

RESERVED 

BEGINNING/LOGIN TIME 

CPU LIMIT 

POINTER TO HIGHER LEVEL TOTALS 

STATUS MASK 

TOTAL'S LENGTH 



USER ACCOUNT BLOCK (UAB) 

NOTE: UAB'S MUST END 



ON A WORD BOUKDRY 
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ACNDF$ 



.=$$$TLN 




B.USE:'L'.BLKB 


1 


B.ACT:'L'.BLKW 


1 


B.tJUIC:'L'.BLKW 


1 


B.UCB:'L'.BLKW 


1 


B.LGOr'L'.BLKW 


3 


B.ULNK:'L'.BLKW 


1 


B.RNA:'L'.BLKW 


3 


B.NAM:'L'.BLKB 


14 


.BLKB 


1 


.BLKB 


1 


B.LDS:'L'.BLKB 


10 


B.ULEK='B'. 




$$$= <.+77>/100 



START AFTER TOTALS 

USE COUNT 

NUMBER OF CURRENTLY ACTIVE TASKS 

LOGIN UIC 

POINTER TO UCB 

LOGOFF TIME 

LINK TO NEXT UAB 

LOC IN SYSTEM ACCNT FILE (OFFSET, VBN-HI.VBN-LD) 

LAST NAME OF USER 

FIRST INITIAL OF USER 

FLAG BYTE FOR UAB (bs.sil) etc. 

LOGIN DIRECTORY STRING 

UAB LENGTH 

UAB LENGTH (ROUNDED UP TO 32 WORD BOUND) 



TASK ACCOUNT BLOCK (TAB) 

NOTE: THE TAB MUST END ON A WORD BOUNDRY 



.=$$$TLN 

B.PRI:'L' 

B.TNAM:'L' 

B.TCB:'L' 

B.TST3:*L' 



B.CUIC 

B.PUIC 

B.CTXT 

B.TCKP 

B.OVLY 

B.EXST 

B.TLEN='B 

B.TBLK»'B 



BLKB 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 2 

.BLKW 2 

.BLKW 2 

<.+77>/100 



STARTS AFTER TOTALS 

HIGHEST RUNNING PRIORITY 

TASK NAME 

TCB ADDRESS 

T.ST3 FROM TASK'S TCB 

RESERVED FOR FUTURE STATUS BITS 

CURRENT UIC OF TASK 

PROTECTION UIC OF TASK 

NUMBER OF CONTEXT LOADS 

TIMES TASK HAS BEEN CHECKPGINTED 

NUMBER OF DISK OVERLAY LOADS 

EXIT STATUS AND ABORT CODE 

TAB LENGTH 

NUMBER OF SEC POOL BLOCKS IN TAB 



SYSTEM ACCOUNT BLOCK (SAB) 



.»$$$TLN 

B.SHDN:'L 

B.UHDi'L 

B.ULO:'L 

B.ULT:'L 

B.CKP:'L 

B.SHF:'L 

B.RND:'L 

B.FID:'L 

B.DVNM: 

B.UNIT 

B.EXTS 

B.LSCN: 

B.SCNR: 

B.DSCN: 

B.STSP 

B.SYSM: 

B.CKUS 

B.CKSP 

B.CKAL: 

B.SLEN 



•L 

•L 

'L 

;'L 

;'L 

;'L 

•L 

;'L 

;'L 

;'L 

:'L 

= <B 



.BLKB 

BLKW 

BLKW 

BLKW 

BLKW 

BLKW 

BLKW 

BLKW 

.BLKB 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 



START AFTER TOTALS 

ACCOUNTING SHUTDOWN REASON CODE 

UAB LISTHEAD 

NUMBER OF USERS CURRENTLY LOGGED ON 

TOTAL NUMBER OF LOGONS 

TOTAL NUMBER OF CHECKPOINTS 

TOTAL NUMBER OF SHUFFLER RUNS 

NUMBER OF CPU INTERVALS ROUNDED UP TO 1 

FILE-ID OF TRANSACTION FILE 

DEVICE OF TRANSACTION FILE 

UNIT OF TRANSACTION FILE 

EXTEND SIZE FOR TRANSACTION FILE 

TIME OF LAST SCAN 

SCAN RATE IN SECONDS 

STATISTICAL SCAN RATE (IN SEC) 

RESERVED 

RESERVED 

RESERVED 

RESERVED 

RESERVED 

SAB LENGTH 
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ACNDF$ 



; NEW FIELDS FOR EXTENDED ACCOUNTING 



B.CPUT: 
B.CTXP: 
B.IDCT: 
B.QIOC: 
B.MIOC: 
B.AIOC: 
B.IPSN: 
B.IPRC: 
B.CKEX: 
B.CFCL: 
B.CFRK: 
B.TLOD: 
B.RLOD: 

B.SSBL= 



.BLKW 8. 

.BLKW 8. 

.BLKW 8. 

.BLKW 8. 

.BLKW 8. 

.BLKW 8. 

.BLKW 8. 

.BLKW 8. 
BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 
.BLKB 82. 
.-B.SLEN 
<.+77>/100 



2 
2 
2 
2 
2 



CPU TIME USED PER PROCESSOR 

NUMBER OF CONTEXT SWITCHES (PER PROC) 

NUMBER OF IDLE LOOP ENTRIES (PER PROC) 

NUMBER OF I/O INITIATIONS (PER PROC) 

MASS STORE I/O COMPLETIONS (PER PROC) 

ALL I/O COMPLETIONS (PER PROC) 

IP INTERRUPTS SENT (PER PROC) 

IP INTERRUPTS RCVD (PER PROC) 

CHECKPOINT DUE TO EXTEND TASKS 

CALLS TO CFORK 

CFORK FORKS 

TASK LOADS 

REGION LOADS 

BUMP SIZE TO NEXT 32 WORD BLOCK 

EXTRA LENGTH OF SYSTEM STATISTICS BLOCK 

SAB LENGTH (ROUNDED UP TO 32 WORD BOUND) 



SYSLOG STARTUP TRANSACTION 

$$$HLN 
B.SSLN=*B' 

^ 
CRASH RECOVERY TRANSACTION 



$$$HLN 
B.CTLSr'L'.BLKW 3 
B.CSRTr'L'.BLKW 1 
B.CRSN:'L'.BLKB 60. 
B.CLEN='B'. 



; START AFTER HEADER 
; TRANSACTION LENGTH 



START AFTER STANDARD HEADER 
TIME OF LAST SCAN BEFORE CRASH 
SCAN RATE BEFORE CRASai 
ASCII TEXT EXPLAINING CRASH 
TRANSACTION LENGTH 



INVALID LOGIN TRANSACTION 



$$$HLN 
B.INAM:'L'.BLKB 14. 
B.IUIC:'L'.BLKB 6. 
B.IPSW:'L'.BLKB 6. 
B.ILEN='B'. 



NAME FROM LOGIN LINE 
UIC FROM LOGIN LINE 
PASSWORD FROM LOGIN LINE 
TRANSACTION LENGTH 



DEVICE TRANSACTIONS (ALLOCATION, DEALLOCATION, MOUNT, AND DISMOUNT) 



B.DNAM: 
B.DUNT: 
B.DLEN= 

B.DLBL: 
B.DMST: 
B.DUIC: 
B.DVPR: 
B.DACP: 
B.MLEN= 



$$$HLN 
'L' .BLKW 1 
•L'.BLKB 1 
'B*. 

.BLKB 1 
'L' .BLKW 6 
•L'.BLKW 1 
'L'.BLKW 1 
•L'.BLKW 1 
'L' .BLKW 2 
'B'. 



ASCII DEVICE NAME 

OCTAL DEVICE UNIT NUMBER 

TRANSACTION LENGTH FOR ALL, DEA. 

UNUSED BYTE 

VOLUME LABEL 

MOUNT STATUS BITS 

OWNER UIC 

VOLUME PROTECTION CODE 

NAME OF ACP FOR DEVICE 

LENGTH OF MOUNT TRANSACTION 



AND DM0 
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ACNDF$ 



STATUS BITS FOR MOUNT STATUS MASK (B.DMST) 



BM.SHR='B'l 
BM.N0S='B'2 
BM.SYS='B'4 
BM.FOR='B'10 



DEVICE IS MOUNTED SHARED 

DEVICE IS MOUNTED NOSHARE 

DEVICE IS MOUNTED FOR THE SYSTEM (PUBLIC) 

DEVICE IS MOUNTED FOREIGN 



SYSTEM TIME CHANGE TRANSACTION 

$$$HLN 
B.TOLD:'L'.BLKB 6 
B.TNEW;'L'.BLKB 6 
B.TMLN='B'. 



OLD TIME (YR. MON. DAY, HR, MIN. SEC) 
NEW TIME (YR, MON, DAY, HR, MIN, SEC) 
TRANSACTION LENGTH 



PRINT DESPOOLER TRANSACTION 



$$$HLN 



B.PNAM: 
B.PPGS: 
B.PNFI; 
B.PFRM; 
B.PPRI: 
B.PDEV: 
B.PPUN: 
B.PLEN= 



.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 
.BLKW 
.BLKB 



START AFTER HEADER 

PRINT JOB NAME (RAD50) 

PAGE COUNT 

NUMBER OF FILES PRINTED 

FORM NUMBER 

PRINT PRIORITY 

PRINT DEVICE NAME (ASCII) 

UNIT NUMBER OF PRINT DEVICE 

TRANSACTION LENGTH 



CARD READER SPOOLING TRANSACTION 



B.RNAM: 
B.RCDS: 
B.RDEV: 
B.RUNT: 
B.RSOP: 



$$$HLN 
■L'.BLKW 
■L' .BLKW 
'L'.BLKW 
•L'.BLKB 
'L' .BLKB 



B.RLEN='B' 



START AFTER HEADER 

BATCH OR PRINT JOB NAME 

NUMBER OF CARDS READ 

READER DEVICE NAME (ASCII) 

UNIT NUMBER OF READER DEVICE 

SUBMIT OR PRINT (0=SUBMIT, 1='PRINT) 

TRANSACTION LENGTH 



LOGIN TRANSACTION 

$$$HLN 
B.LUIC: 'L'.BLKW 1 
B.LNAM: 'L'.BLKB 14. 

.BLKB 1 
B.LLEN='B'. 



START AFTER HEADER 
LOGIN UIC 
USER'S LAST NAME 
AND FIRST INITIAL 
TRANSACTION LENGTH 



RESET TRANSACTION PARAMETERS 
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ACNDF$ 



.»$$$HLN 



B.OFID:'L'.BLKW 3 


B.ODNM:<L'.BLKB 2 


B.OUNT:'L'.BLKW 1 


B.NFID:'L' .BLKW 3 


B.NDNM:'L' .BLKB 2 


B.NUMT:'L' .BLKW 1 


B.OEXS:'L'.BLKW 1 


B.NEXS:'L'.BLKW 1 


B.OSCR:'L' .BLKW 1 


B.NSCIR:'L'.BLKW 1 


B.ODSC: 'L' .BLKW 1 


B.NDSC:'L'.BLKW 1 


B.RTLN='B' . 


; + 

; TRANSACTION TYPES 


; 000 THRU 127 


; 128 THRU 255 


BT.SAB='B'l 


BT.UAB='B'2 


BT.TAB='B'3 


BT.SS='B'll 


BT.INV='B'12 


BT.TIM='B'13 


BT.ALL='B'14 


BT.DEA='B'15 


BT.M0U='B'16 


BT.DM0='B'17 


BT.PRT='B'20 


BT.DIR='B'21 


BT.V0L='B'22 


BT.L0G='B'23 


BT.CRH='B'24 


BT.DST='B'25 


BT.RTP='B'26 


BT.INP='B'27 



AFTER HEADER 
FILE-ID OF OLD TRN. FILE 
DEVICE OF OLD TRN. FILE 
UNIT OF OLD TRN. FILE 
FILE- ID OF NEW TRN. FILE 
DEVICE OF NEW TRN. FILE 
UNIT OF NEW TRN. FILE 
EXT. SIZE FOR OLD TRN. FILE 
EXT. SIZE FOR NEW TRN. FILE 
OLD SCAN RATE IN SECONDS 
NEW SCAN RATE IN SECONDS 
OLD STATISTICAL SCAN RATE 
NEW STATISTICAL SCAN RATE 



RESERVED FOR DEC USE 
RESERVED FOR CUSTOMER USE 



SYSTEM ACCOUNT BLOCK (SAB) 
USER ACCOUNT BLOCK (UAB) 
TASK ACCOUNT BLOCK (TAB) 
SYSLOG STARTUP TRANSACTION 
INVALID LOGIN TRANSACTION 
SYSTEM TIME CHANGE TRANSACTION 
ALLOCATE DEVICE TRANSACTION 
DEALLOCATE DEVICE TRANSACTION 
MOUNT DEVICE TRANSACTION 
DISMOUNT DEVICE TRANSACTION 
PRINT DESPOOLER TRANSACTION 
DISK ACCOUNTING BY DIRECTORY 
DISK ACCOUNTING BY VOLUME 
LOGIN TRANSACTION 
CRASH RECOVERY TRANSACTION 
DEVICE STATISTICS (UCB EXTENSION) 
RESET TRANSACTION PARAMETERS 
CARD READER SPOOLING TRANSACTION 



(UNSUPPORTED) 
(UNSUPPORTED) 



STATUS MASK BIT DEFINITIONS (B.STM) 



BS.ACT='B'200 

BS.CRH='B'100 

BS.LG0='B<40 

BS.C0='B'40 

BS.TML='B'20 

BS.SIL='B'20 

BS.ZER='B'10 

BS.SCN='B'4 



CONTROL BLOCK ACTIVE 

RECORD FROM "TMP" FILE AFTER SYSTEM CRASH 

LOGGED OFF WITH OUTSTANDING ACTIVITY (UAB) 

TASK'S TI: IS CO: (TAB ONLY) 

TAB EXISTS ONLY FOR TIME LIMIT (TAB ONLY) 

SILENT LOGIN/LOGOUT (UAB ONLY) 

LAST CPU INTERVAL WAS OF LENGTH ZERO 

TRANSACTION READY FOR WRITE TO SCAN FILE 



ACCOUNTING FEATURE MASK ($ACNFE) 
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ACNDF$ 



BF.DST= 


B' 40000 


BF.WRT= 


B'20OO 


BF.SCN= 


B ■ 1000 


BF.SLR= 


B'400 


BF.ERR= 


B'200 


BF.STK= 


B'lOO 


BF.LSS= 


B'40 


BF.TRN= 


B'lO 


BF.XTK= 


B'4 


BF.TSK= 


B'2 


BF.XAC= 


B'l 



STATISTICAL SCAN RATE 

FORCE SYSLOG TO WRITE ITS BUFFER 

SCAN REQUESTED 

SYSLOG IS RUNNING (NOT STOPPED) 

ACCOUNTING STOPPED DUE TO FATAL ERROR 

ACCOUNTING IS STARTING UP / SHUTTING DOWN 

ACCUMULATE SYSTEM STATISTICS (POINT UAB TO SAB) 

OUTPUT TO TRANSACTION FILE 

CHECKPOINT REQUEST IS DUE TO EXTK$ 

TASK ACCOUNTING TURNED ON 

EXTENDED ACCOUNTING ASSEMBLED IN 



SHUTDOWN CODES (B.SHDN) 



MAINTENANCE 

REBOOT 

SCHEDULED.SHUTDOWN 

ACCOUNTING SHUTDOWN BY TASK "SHUTUP" 

OTHER 



B.MAXL='B'128. ; MAXIMUM TRANSACTION LENGTH 

B.MINL='B'$$$HLN ; MINIMUM TRANSACTION LENGTH 



.PSECT 






.MACRO 


ACNDF$ 


X, 


.ENDM 






,ENDM 






.MACRO 


ACTDF$,L,B 


.ASECT 






.=0 






A.GRP:'L' 


.BLKB 


3 


A.MBR:'L' 


.BLKB 


3 


A.PSWD: 'L' 


.BLKB 


6 


A.LNM:'L' 


.BLKB 


14 


A.FNMi'L' 


.BLKB 


12 


A.LDAT:'L' 


.BLKB 


6 


A.NLOG:'L' 


.BLKB 


2 


A.SYDV:'L' 


.BLKB 


4 


A.ACN:'L' 


.BLKW 


1 


A.CLI:'L' 


.BLKW 


2 




.BLKW 


2 


A.LPRV:'L' 


.BLKW 


1 


A.SID: 'L' 


.BLKW 


1 


A.DDS:'L' 


.BLKB 


11 




.BLKB 


1 


A.FPRO:'L' 


.BLKW 


1 


A.RLVL:'L' 


.BLKW 


1 


AR.LVL='B'401 






A.SALT:'L' 


.BLKW 


1 


A.ENCT:'L' 


.BLKB 


1 



.BLKB 



GROUP CODE (ASCII) 

MEMBER CODE 

PASSWORD 

LAST NAME 

FIRST NAME 

DATE OF LAST LOG ON (DD/MM/YY HH:MM:SS 

TOTAL NUMBER OF LOGONS 

DEFAULT SYSTEM DEVICE 
ACCOUNT NUMBER (BINARY) 

RAD50 USER CLI 

UNUSED 
LOGIN PRIVILEGE WORD 

SESSION IDENTIFIER 
DEFAULT DIRECTORY STRING 
UNUSED BYTE 

DEFAULT FILE PROTECTION 
ACCOUNT RECORD REV. LEVEL 

16-BIT ENCRYPTION SALT VALUE 
ENCRYPTION TYPE 

= PLAIN TEXT OR ENCRPT 

1 = PURDY-V ALGORITHM 
UNUSED 
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A.HPW:'L' 


.BLKW 


4 ; 




.IF DF 


A$$LOG 


A.TTY:'L' 
A.PRID:'L' 
A.SECD;'L' 
A.PRIT:'L' 
A. SECT: 'L' 
A.RLEN ='B' 


.BLKB 
.BLKB 
.BLKB 
.BLKW 
.BLKW 


5 ; 
1 ; 
1 ; 
1 ; 
1 ; 




.ENDC 


; DF A$$L06 


A.LEN ='B' 


128. 


> 



HASHED PASSWORD 



TERMINAL TTNNN FOR AUTO LOGIN 
PRIMARY DAYS MASK 
SECONDARY DAYS MASK 
PRIMARY DAYS TIME 
SECONDARY DAYS TIME 



LENGTH OF CONTROL BLOCK 



BIT DEFINITIONS ON A.LPRV - LOGIN PRIVILEGE BITS 



AL.SLV='B' 
AL.DDS='B' 
AL.SIL='B' 


1 ; 

2 : 
4 ; 
.IF DF A$$LOG 


AL.AUT-'B' 
AL.BND='B' 
AL.RMT='B' 
AL.NET='B' 
AL.DIS='B' 
AL.PRI='B' 
AL.SEC='B' 


10 ; 

20 ; 

40 ; 

100 

200 

400 

1000 




.ENDC : DF A$$LOG 


.PSECT 
.ENDM 





SLAVE TERMINAL ON LOGIN 
INDICATOR FOR PROLOGUE 2 FORMAT 
SILENT LOGIN/LOGOUT 

AUTO LOGIN ENABLED ('*) 

BINDING ENABLED ('Y) 

REMOTE DIALUP 1=N0 

NETWORK LOGIN 1=N0 

DISABLE THIS ACCOUNT FROM LOGIN 

PRIMARY DAYS LIMIT SET 

SECONDARY DAYS LIMIT SET 
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.MACRO CLKDF$.L.6 

I- 
CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS 

CLOCK QUEUE CONTROL BLOCK 

THERE ARE FIVE TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL BLOCK HAS 
THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS IN THE REMAINING THREE. 

THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED: 



C.MRKT='B'0 

C.SCHD='B'2 

C.SSHT='B'4 

C.SYST='B'6 

C.SYTK='B'8. 

C.CSTP='B'10. 



MARK TIME REQUEST 

TASK REQUEST WITH PERIODIC RESCHEDULING 

SINGLE SHOT TASK REQUEST 

SINGLE SHOT INTERNAL SYSTEM SUBROUTINE (IDENT) 

SINGLE SHOT INTERNAL SYSTEM SUBROUTINE (TASK) 

CLEAR STOP BIT (CONDITIONALIZED ON SHUFFLING) 



CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS 



.=0 

C.LNK:'L' 

C.RQTr'L' 

C.EFN:'L' 

C.TCB:'L' 

C.TIM: 'L' 



.ASECT 

.BLKW 
.BLKB 
.BLKB 
.BLKW 
.BLKW 



CLOCK QUEUE THREAD WORD 

REQUEST TYPE 

EVENT FLAG NUMBER (MARK TIME ONLY) 

TCB ADDRESS OR SYSTEM SUBROUTINE IDENTIFICATION 

ABSOLUTE TIME WHEN REQUEST COMES DUE 



CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS 



.=C.TIM+4 

C.AST:'L' .BLKW 1 

C.SRC:'L' .BLKW 1 

C.DST:'L' .BLKW 1 

.BLKW 1 



START OF DEPENDENT AREA 

AST ADDRESS 

FLAG MASK WORD FOR 'BIS' SOURCE 

ADDRESS OF 'BIS' DESTINATION 

UNUSED 



CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET DEFINITIONS 



.=C.TIM+4 
C.RSI:'L' .BLKW 2 
C.UIC:'L' .BLKW 1 
C.UAB:'L'.BLKW 1 



START OF DEPENDENT AREA 
RESCHEDULE INTERVAL IN CLOCK TICKS 
SCHEDULING UIC 
POINTER TO ASSOCIATED UAB 



CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS 



=C.TIM+4 

.BLKW 2 

.BLKW 1 

.BLKW 1 



START OF DEPENDENT AREA 
TWO UNUSED WORDS 
SCHEDULING UIC 
C.UAB 
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CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET DEFINITIONS 

THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST: 'L' 

TYPE 6=SINGLE SHOT INTERNAL SUBROUTINE WITH A 16 BIT VALUE AS AN IDENTIFIER. 
TYPE 8=SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS AS AN IDENTIFIER. 



.=C.TIM+4 
C.SUB:'L' .BLKW 1 
C.AR5:'L' .BLKW 1 
C.URM: 'L'.BLKW 1 

.BLKW 1 
C.LGTH='B'. 



START OF DEPENDENT AREA 

SUBROUTINE ADDRESS 

RELOCATION BASE (FOR LOADABLE DRIVERS) 

URM TO EXECUTE ROUTINE ON 

(MP SYSTEMS. C.SYST ONLY) 

UNUSED 

LENGTH OF CLOCK QUEUE CONTROL BLOCK 



NAMED DIRECTORY SUPPORT 



OFFSET C.EFN WILL BE REUSED IN SCHEDULING REQUESTS TO INDICATE IF C.UIC 
HAS A VALID UIC (C.NAM=0) OR IF C.UIC POINTS TO A CONTEXT BLOCK WITH A DDS. 
IN SCHEDULE REQUESTS, C.EFN WILL BE REFERRED TO AS C.NAM. 

C.NAM='B'C.EFN ; FLAG WORD FOR USE WITH NAME DIRECTORIES 

DEPENDING ON THE VALUE IN C.NAM, C.UIC WILL CONTAIN A UIC OR A POINTER 
TO A CONTEXT BLOCK. C.UIC WILL BE REFERED TO AS C.CTX WHEN IT CONTAINS 
A POINTER TO A CONTEXT BLOCK. 

C.CTX='B 'C.UIC ; POINTER TO CONTEXT BLOCK 



.PSECT 

.MACRO CLKDF$ X.Y 

.ENDM 

.ENDM 
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CTBDF$ 



.MACRO 



CTBDF$,L.B.SYSDEF 



CONTROLLER TABLE (GTB) 

THE CONTROLLER TABLE IS A CONTROL BLOCK THAT CONTAINS A VECTOR 
OF KRB ADDRESSES. THIS VECTOR MAY BE ADDRESSED BY THE CONTROLLER 
INDEX TAKEN FROM THE INTERRUPT PS BY $INTSV/$INTSE. 



.ASECT 



=177756 



L.CLK: 


'L' 


.BLKW 8 


L.ICB: 


•L' 


.BLKW 1 


L.LNK: 


•L' 


.BLKW 1 


L.NAM: 


'L' 


.BLKW 1 


L.DCB: 


•L' 


.BLKW 1 


L.NUM: 


•L' 


.BLKB 1 


L.STS: 


•L' 


.BLKB 1 


L.KRB: 


•L' 


.BLKW 1 



START OF CLOCK BLOCK (IF ANY) 

ICB CHAIN FOR THIS CTB 

CTB LINK WORD 

GENERIC CONTROLLER NAME (ASCII) 

DCB ADDRESS OF THIS DEVICE 

NUMBER OF KRB ADDRESSES IN TABLE 

CTB STATUS BYTE 

START OF KRB ADDRESSES. 



NOTE: THE SYMBOL $XYCTB: : IS DEFINED FOR EACH CTB, WHERE THE 
CHARACTERS XY ARE THE SAME AS THOSE STORED IN L.NAM. THE 
SYMBOL IS NOT THE START OF THE CTB. BUT INSTEAD THE START OF 
THE KRB TABLE AT THE END OF THE CTB (L.KRB) . 



.PSECT 



CONTROLLER TABLE STATUS BYTE BIT DEFINITIONS 



LS.CLK='B'l 

LS.MDC='B'2 

LS.CBL='B'4 

LS.CIN='B'10 

LS.NET'B'=20 



; CLOCK BLOCK AT TOP OF CTB (1=YES) 
;MULTIDRIVER CTB. (1=YES) 
; CLOCK BLK LINKED INTO CLK Q (l=YES) 
;CONT. USE COMMON INT TABLE (1=YES) 
;THIS IS DECNET DEVICE. ICB'S IN K.PRM. (1=YES) 



COMMON INTERRUPT TABLE DISPATCH ENTRY POINTS 



CI.CSR='B'-6 




CI.KRB='B'-4 




CI.PWF='B'-2 




CI.INT='B'0 




CI.DCB='B'2 




.MACRO 


CTBDF$.X,Y.Z 


.ENDM 




.ENDM 





CSR TEST ENTRY POINT 

KRB STATUS CHANGE ENTRY POINT 

POWERFAIL ENTRY POINT 

COMMON INTERRUPT ADDRESS 

START OF DCB TABLE (0 ENDS TABLE) 
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DCBDF$ 



DEVICE CONTROL BLOCK 

THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC INFORMATION ABOUT A DEVICE 
TYPE AND THE LOWEST AND HIGHEST UNIT NUMBERS. THERE IS AT LEAST ONE DCB 
FOR EACH DEVICE TYPE IN A SYSTEM. FOR EXAMPLE. IF THERE ARE TELETYPES IN A 
SYSTEM. THEN THERE IS AT LEAST ONE DCB WITH THE DEVICE NAME 'TT' . IF PART 
OF THE TELETYPES WERE INTERFACED VIA DLll-A'S AND THE REST VIA A DHll, THEN 
THERE WOULD BE TWO DCB'S. ONE FOR ALL DLll-A INTERFACED TELETYPES, AND ONE 
FOR ALL DHll INTERFACED TELETYPES. 



.=0 

D.LNK:' 

D.UCB:' 

D.NAM:' 

D.UNIT; 

D.UCBL; 
D.DSP:' 
D.NSK:' 



.ASECT 

L' .BLKW 1 
L' .BLKW 1 
L' .BLKW 1 
'L" .BLKB 1 

.BLKB 1 
'L' .BLKW 1 



D.PCB: 



L' .BLKW 
L' .BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

-BLKW 

.BLKW 

.BLKW 
L' .BLKW 

.PSECT 



LINK TO NEXT DCB 

POINTER TO FIRST UNIT CONTROL BLOCK 

GENERIC DEVICE NAME 

LOWEST UNIT NUMBER COVHIED BY THIS DCB 

HIGHEST UNIT NUMBER COVERED BY THIS DCB 

LENGTH OF EACH UNIT CONTROL BLOCK IN BYTES 

POINTER TO DRIVER DISPATCH TABLE 

LEGAL FUNCTION MASK CODES 0-15. 

CONTROL FUNCTION MASK CODES 0-15. 

NOP 'ED FUNCTION MASK CODES 0-15. 

ACP FUNCTION MASK CODES 0-15. 

LEGAL FUNCTION MASK CODES 16.-31. 

CONTROL FUNCTION MASK CODES 16.-31. 

NOP 'ED FUNCTION MASK CODES 16.-31. 

ACP FUNCTION MASK CODES 16.-31. 

LOADABLE DRIVER PCB ADDRESS 



DRIVER DISPATCH TABLE OFFSET DEFINITIONS 



D.VDEB='B'-2 
D.VCHK='B'-4 



D.VNXC='B'-4 

D.VT0U='B'-10 

D.VTIN='B'-6 

D.VINI='B'0 

D.VCAN='B'2 

D.V0UT='B'4 

D.VPWF='B'6 

D.VKRB='B'10 

D.VUCB='B'12 



DEALLOCATE BUFFER (S) 

ADDRESS OF ROUTINE CALLED TO VALIDATE 

AND CONVERT THE LBN. USED BY DRIVERS 

THAT SUPPORT SEEK OPTIMIZATION. 

ADDRESS OF ROUTINE IN TTDRV CALLED TO 

HAVE IT SEND THE NEXT COMMAND IN THE 

TYPEAHEAD BUFFER TO MCR. . . 

ADDRESS OF ROUTINE IN TTDRV CALLED 

FOR OUTPUT COMPLETION 

ADDRESS OF ROUTINE IN TTDRV CALLED 

FOR INPUT FROM THE CT FIIWWARE TASK 

DEVICE INITIATOR 

CANCEL CURRENT I/O FmiCTION 

DEVICE TIMEOUT 

POWERFAIL RECOVERY 

CONTROLLER STATUS CHANGE ENTRY 

UNIT STATUS CHANGE ENTRY 



.IF NB SYSDEF 
D.VINT='B'14 



; BEGINNING OF INTERRUPT STUFF 
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.ENDC 

.MACRO DCBDF$,X,Y.Z 

.ENDM 
.ENDM 
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.MACRO EPKDF$,L.B 
Error Message Block Definitions 

.ASECT 
Header Subpacket 



+ + 

I Subpacket Length in Bytes | 

+ + 

I Subpacket Flags | 

+ : + , + 

I Format Identification I Operating System Code I 

+ + + 

I Operating System Identification | 

I I 

+ + . + 

I Flags I Context Code I 

+ + + 

I Entry Sequence I 

+ + 

I Error Sequence I 

+ + + 

I Entry Type Subcode I Entry Type Code I 

+ + + 

I Time Stamp I 

I I 

I I 

+ + + 

I Reserved I Processor Type I 

+ + + 

I Processor Identification (URM) I 

+ + 



.=0 



E$HLGH: 


'L' 


.BLKW 1 


E$HSBF : 


'L' 


.BLKW 1 


EIHSYS: 


•L' 


.BLKB 1 


E$HIDN: 


'L' 


.BLKB i 


E$HSID: 


'L' 


.BLKB 4 


E$HCTX: 


•L' 


.BLKB 1 


E$HFL6: 


'L' 


.BLKB 1 


E$HEHS: 


•L' 


.BLKW 1 


E$HERS: 


'L' 


.BLKW 1 


E$HENC: 


•L' 




E$HTYC: 


'L' 


.BLKB 1 


E$HTYS: 


'L' 


.BLKB 1 


E$HTIM: 


•L' 


.BLKB 6 


E$HPTY: 


'L* 


.BLKB 1 
.BLKB 1 


E$HURM: 


■L' 


.BLKW 1 



Subpacket length in bytes 

Subpacket Flags 

Operating System Code 

Format Identification 

Operating System Identification 

Context Code 

Flags 

Entry Sequence Number 

Error Sequence Number 

Entry Code 

Entry Type Code 

Entry Type Subcode 

Time Stamp 

Processor Type 

Reserved 

Processor Identification (URM) 
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.EVEN 



E$HLEN:'L' 




Length 


; Subpacket Flags for E$HSBF 




SM.mR 


= 'B' 1 


Error Packet 


SM.HDR 


= 'B' 1 


Header Subpacket 


SM.TSK 


= 'B' 2 


Task Subpacket 


SM.DID 


= 'B' 4 


Device Identification Subpacket 


SM.DOP 


='B' 10 


Device Operation Subpacket 


SM.DAC 


='B' 20 


Device Activity Subpacket 


SM.DAT 


='B' 40 


Data Subpacket 


SM.MBC 


='B' 20000 


22-bit massbus controller present 


SM.CMD 


='B' 40000 


Error Log Command Packet 


SM.ZER 


='B' 100000 


Zero I/O Coimts 


: Codes for field E$HIDN 




EHIFOR 


= 'B' 2 


Current packet format 


; Flags for the 


error log flags byte ($ERFLA) in the exec. 


ES.INI 


= >B' 1 


Error log initialized 


ES.DAT 


= 'B' 2 


Error log receiving data packets 


ES.LIM 


= 'B' 4 


Error limiting enabled 


ES.LOG 


='B' 10 


Error logging enabled 



Type and Subtype Codes for fields E$HTYC and E$HTYS 

Symbols with names E$Cxxx are type codes for field E$HTYC, 
symbols with names E$Sxxx are subtype codes for field E$HTYS. 



Error Log Control 

Error Log Status Change 

Switch Logging Files 

Append File 

Declare Backup File 

Show 

Change Limits 

Device Errors 

Device Hard Error 

Device Soft Error 

Device Interrupt Timeout (HARD) 

Device Unsolicited Interrupt 

Device Interrupt Timeout (SOFT) 

Device Information 

Device Information Message 

Device Control Information 
Device Mount 
Device Dismount 
Device Count Reset 
Block Replacement 

Memory Detected Errors 
Memory Error 



E$CCMD 


= 'B 


1 


E$SSTA 


= 'B 


1 


E$SSWI 


= 'B 


2 


E$SAPP 


= 'B 


3 


E$SBAC 


= 'B 


4 


E$SSHO 


= 'B 


5 


E$SCHL 


= 'B 


6 


E$CERR 


= 'B 


2 


E$SDVH 


3<B 


1 


E$SDVS 


= 'B 


2 


E$STMO 


= 'B 


3 


E$SUNS 


= 'B 


4 


E$STMS 


= 'B 


5 


E$CDVI 


= 'B 


3 


E$SDVI 


= 'B 


1 


E$CDCI 


= 'B 


4 


E$SMOU 


= 'B 


1 


EISDMG 


= 'B 


2 


E$SRES 


= 'B 


3 


E$SRCT 


= 'B 


4 


E$CMEM 


= 'B 


5 


E$SMEM 


= 'B 


1 
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E$CSYS 


= 'B' 6 


E$SPWR 


= 'B' 1 


E$CCTL 


= 'B' 7 


E$STIM 


= 'B' 1 


EISCRS 


= 'B' 2 


ESSLOA 


= 'B' 3 


E$SUNL 


= 'B' 4 


E$SHRC 


= >B' 5 


E$SMES 


= 'B' 6 


E$CCPU 


='B' 10 


E$SINT 


= 'B' 1 


: E$SINT 


= 'B' 2 


; Subtype code 


2 is reserved. 


E$CSDE 


='B' 11 


E$SABO 


= 'B' 1 


; Codes for Context Code entry 


EH$NOR 


= 'B' 1 


EH$STA 


= 'B' 2 


EH$CRS 


= 'B' 3 


; Codes for Flags entry E$HFLG 


EH$VIR 


= 'B' 1 


EH$EXT 


= 'B' 2 


EH$COU 


= 'B' 4 


EH$qBS 


='B' 10 


EH$LMR 


='B' 20 


; Task Subpacket 



System Control Information 
Power Recovery 

Control Information 
Time Change 
System Crash 
Device Driver Load 
Device Driver Unload 
Reconfiguration Status Change 
Message 

CPU Detected Errors 

Unexpected Interrupt 
Unexpected Interrupt 
Use 3 for the next following Subtype code 

; Software Detected Events 
; Task Abort 



Normal Entry 
Start Entry 
Crash Entry 



Addresses are virtual 
Addresses are extended 
Error counts supplied 
q-BUS CPU 
Limit reached 



I Task Subpacket Length 



I Task Name in RAD50 
I 



I Task UIC 

+ 

I Task TI: Device Name 



I Flags 



I Task TI: Unit Number I 

.+ + 



.=0 



E$TLGH: 


'L' 


.BLKW 


1 


Task Subpacket Length 


E$TTSK: 


'L' 


.BLKW 


2 


Task Name in RAD50 


E$TUIC: 


'L' 


.BLKW 


1 


Task UIC 


EITTID: 


'L' 


.BLKB 


2 


Task TI: Device Name 


E$TTIU: 


'L' 


.BLKB 


1 


Task TI: Unit 


E$TFLG: 


'L' 


.BLKB 


1 


Flags 



.EVEN 



E$TLEN:'L' 
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Flags for entry E$TFLG 

ET$PRV ='B' 
ET$PRI ='B' 



1 ; Task is Privileged 

2 ; Terminal is Privileged 



Device Identification Subpacket 



Device Identification Subpacket Length 



I Device Mnemonic Kame 



I Controller Number 
+ 

I Physical Subunit # 



I Reserved 



I Flags 



I Volume Name of Mounted Volume 
I 



I Pack Identification 

I 

+ 

I 
+■ 



Device Type Class 
Device Type 



I/O Operation Count Longword 



I 



I Device Unit Number I 

-+ + 

I Physical Unit # I 



I Physical Device Mnemonic (RSX-llM-PLUS only) I 

+ + + 



Hard Error Count I Soft Error Count 

+ 

Blocks Transferred Count (RSX-llM-PLUS only) 



I Cylinders Crossed Count (RSX-llM-PLUS only) 
I 

+ ■ 



E$ILGH:'L' 
E$ILDV:'L' 
E$ILUN:'L' 
E$IPCO:'L' 
E$IPUN:'L' 
E$IPSU: 'L' 



E$IPDV:'L' 



.BLKW 
.BLKW 
.6LKB 
.BLKB 
.BLKB 
.BLKB 

.IF DF R$$MPL 

.BLKW i 



Device Identification Subpacket Length 

Device Mnemonic Neune 

Device Unit Number 

Controller Number 

Physical Unit Number 

Physical Subunit Number 



Physical Device Mnemonic 
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.ENDC ; R$$MPL 



E$IFLG: 


'L' 


.BLKB 


1 


Flags 






.BLKB 


1 


Reserved 


E$IVOL: 


'L' 


.BLKB 


12. 


Volume Name 


E$IPAK: 


'L' 


.BLKB 


4 


Pack Identification 


E$IDEV: 


'L' 






Device Type 


E$IDCL: 


'L' 


.BLKW 


1 


Device Type Class 


E$IDTY: 


•L' 


.BLKW 


2 


Device Type 


E$IOPR: 


'L' 


-BLKW 


2 


I/O Operation Count Longword 


E$IERS: 


■L' 


.BLKB 


1 


Soft Error Count 


E$IERH: 


•L' 


.BLKB 


1 


Hard Error Count 






.IF DF R$$MPL 




E$IBLK: 


•L' 


.BLKW 


2 


Blocks transferred count 


E$ICYL: 


■L* 


.BLKW 


2 


Cylinders crossed count 



.ENDC : R$$MPL 



.EVEN 



E$ILEN:'L' 

Flags for field E$IFL6 

EI$SUB ='B' 1 
. IF DF R$$MPL 

EI$NUX ='B' 2 
.ENDC ; R$$MPL 

Device Operation Subpacket 



Subpacket Length 



Subcontroller device 



No UCB extension, data invalid 



Device Operation Subpackeli Length 


Task Name in RAD50 


Task UIC 


Task TI: Logical Device 


Mnemonic 




Reserved 


1 


Task TI: Device Unit 


I/O Function Code 








Reserved 


1 


Operation 


Flags 


Transfer Operation 


Address 




Transfer Operation Byte 


Count 




MaximiM Retries 


1 


Retries Left 



.=0 
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£$OLGN: 


'L' 


.BLKW 


1 




E*OTSK: 


'L' 


.BLKW 


2 




E$OUIC: 


■L' 


.BLKW 


1 




ESOTID: 


'L' 


.BLKB 


2 




E$OTIU: 


•L' 


.BLKB 
.BLKB 


1 
1 




E$OFNC: 


•L' 


.BLKW 


1 




E$0FL6: 


■L' 


.BLKB 
.BLKB 


1 

1 




E$OADD: 


'L' 


.BLKW 


2 




E$OSIZ: 


•L' 


.BLKW 


1 




EIORTY; 


•L- 
.EVEN 


.BLKB 
.BLKB 


1 

1 




E$OLEN: 


'L' 








; Flags for field E$OFLG 






EO$TRA 


= 'B' 




1 




EQ$DMA 


= <B' 




2 




EO$EXT 


= 'B' 




4 




EO$PIP 


= 'B' 




10 




EO$IIO 


= <B' 




20 



I/O Activity Subpacket 



Subpacket Length 

Task Name in RAD50 

Task UIC 

Task TI: Logical Device Mnemonic 

Task TI: Logical Device Unit 

Reserved 

I/O Function Code 

Operation Flags 

Reserved 

Transfer Operation Address 

Transfer Operation Byte Count 

Retries Left 

Maximum Retries 



Device Operation Subpacket Length 



Transfer Operation 

DMA Device 

Extended Addressing Device 

Device is positioning 

Internal I/O operation 



I I/O Activity Subpacket Length 

+ . 



.=0 
EIALGH: 'L' 



.BLKW 



: Subpacket Length 
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I/O Activity Subpacket Entry 

+ + 

I Logical Device Name Mnemonic I 

+ : + + 

I Controller Number I Logical Device Unit I 
+ + + 

I Physical Subunit # I Physical Unit Number I 

+ — + + 

I Physical Device Mnemonic (RSX-llM-PLUS only) I 

+ + ■ + 

I Task TI: logical unit I Device flags I 

+ ■ + '■ ■ + 

I Requesting Task Name in RAD50 I 

I I 

+ — . + 

I Requesting Task UIC I 

+ ■ -^ + 

I Task TI: Logical Device Name I 

+ ■ ^ + 

I I/O Function Code I 

+ '■ + ■ — + 

I Reserved I Flags I 

+ +- — : • -+ 

I Transfer Operation Address I 

I I 

+ _ . + 

I Transfer Operation Byte Count I 

+ --■ + 



E$ALDV: 


■L" 


.BLKW 




Logical Device Name Mnemonic 


E$ALUN: 


'L' 


.BLKB 




Logical Device Unit 


E$APCO: 


•L' 


.BLKB 




Controller Number 


E$APUN: 


'L' 


.BLKB 




Physical Unit Number 


E$APSU: 


•L' 


.BLKB 




Physical Subunit Number 






.IF DF R$$MPL 




E$APDV: 


•L- 


.BLKW 
.ENDC 


1 


Physical Device Mnemonic 


E$ADFG: 


•L' 


.BLKB 


1 


Device flags 


E$ATIU: 


'L' 


.BLKB 


1 


Task TI : Logical Unit 


EIATSK: 


•L' 


.BLKW 


2 


Requesting Task Name in RAD50 


EIAUIC: 


'L' 


.BLKW 


i 


Requesting Task UIC 


E$ATID: 


■L- 


.BLKW 


1 


Task TI: Logical Device Name 


E$AFNC: 


•L' 


.BLKW 


1 


I/O Function Code 


E$AFLG: 


'L' 


.BLKB 


1 


Flags 






.BLKB 


1 


Reserved 


E$AADD: 


'L' 


.BLKW 


2 


Transfer Operation Address 


E$ASIZ: 


'L' 


.BLKW 


i 


Transfer Operation Byte Count 



.EVEN 
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E$ALEN:'L' 

Flags for field E$ADFG 

EA$SUB ="B' 1 
.IF DF R$$MPL 

EA$NUX ='B' 2 
.ENDC ; R$$MPL 

Flags for field E$AFLG 

EA$TRA ='B' 1 

EA$DMA =<B' 2 

EA$EXT ='B' 4 

EA$PIP ='B' 10 

EA$IIO ='B" 20 
.PSECT 



Subpacket Entry Length 



Subcontroller device 



No UCB extension, data invalid 



Transfer Operation 

DMA Device 

Device has Extended Addressing 

Device is positioning 

Internal I/O operation 



FLAG DEFINITIONS FOR ERROR LOG FEATURE MASK 



EL.ICM ='B" 
EL.SEF ='B' 
EL.MOU ='B' 



SET - INHIBIT OPERATOR CONSOLE MESSAGES 
SET - SPECIAL FILE FORMATS ENABLED 
SET - PROCESS MOU/DMO IN SPECIAL FILES 



.MACRO EPKDF$ X,Y 
.ENDM 

.ENDM 
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.SBTTL EVNDF$ -- TSA Event Packet Definitions 



EVNDF$ 



Event Packet Definitions 



This macro defines symbols for Event Packet offsets and fields 
needed to support Digital's Terminal Software Architecture on RSX. 



Explicit Inputs: 



L ":" for global offset definitions 
B "=" for global bit/value definitions 
LST "LIST" for macro expansion listing 



Implicit Inputs: 

NONE 
Outputs : 



Symbols defined as described above. 
Listing as described above. 



.MACRO EVNDF$ L.B.LST 
.IIF NB LST .LIST 

General packet header format 

.ASECT 
.=0 



E.VLNK 
E.VSIZ 
E.VTYP 
E.VUCB 



•L' 
'L' 
•L' 
'L' 



.BLKW 1 

.BLKB 1 

.BLKB 1 

.BLKW 1 



E.VTYP Values 



ET.L0W='B'O 



ET.QI0= 
ET.BND= 
ET.UNB= 
ET.BCP= 
ET.REJ= 
ET.DIS= 
ET.DCP= 
ET.ICS= 
ET.OOB= 
ET.ON0= 
ET.PHO= 



B'O 

B'2 

B'4 

B'6 

B'lO 

B'12 

B'14 

B'16 

B<20 

B<22 

B'24 



ET.HI='B'24 



Conditionally list macro expansion 



Define offsets absolutely 

Link word 
Packet size 
Packet type 
Terminal UCB address 



Lowest valid type code 

qiO (distinguishes QIO packet from TEP) 

Bind Request 

Unbind Request 

Bind Complete 

Bind Reject 

Disconnect Notification 

Disconnect Complete 

Input Count State Change 

Out-of-Band (OOB) 

Abnormal Termination Request 

Physical Terminal Disconnected 

Highest valid type code 
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The following definitions are for packet types that require 
passing additional information in the packets, All other packet 
types use the general packet format described above. 



Bind Request packet (Terminal Management Mode — > NetWork) 
.=E.VUCB+2 



E.VBCT:'L' 
E.VBND:'L' 
E.VBLN:'L' 



.BLKW 
.BLKB 



Count of nodes (One for now) 

Node name 

Length of bind request 



Input Count State Change. Out-Of-Band packets (TTDRV ~> Network) 
And Modem Hang-up packets (TSA. . . — > Network) 



.=E.VUCB+2 



E.VAPR:'L' 
E.VADR:'L' 
E.VFLG:'L' 



.BLKW 1 
.BLKW 1 
.BLKW 1 



Doubleword address of packet. 

. . .queueing routine 

Flag 



Input Count State (Hiange 

.=E.VFLG+2 
E.VSLNi'L' 



; Length of Input state message 



OOB 



"E.VFLG+2 



E.VOBM:'L' 
E.VHDR:'L' 
E.VTAB;'L' 
E.VOLNi'L' 



.BLKW 6 
.BLKW 2 
.BLKB 10. 



Out-of-Band bitmasks 
Type-ahead buffer header 
Type-ahead buffer 
Length of OOB packet 



Terminal Management Switch Characters 
.=E.VFLG+2 



E.VSWC:'L' 
E.VTLN:'L' 



.BLKW 



Terminal management switch characters 
Length of Switch Character packet 



Bit values in flag word (E.VFLG). For convenience some bits have 

corresponding bits in the AST Control Block flag word (A.PRM+5). 



EF.NCO='B'l 

EF.N0I='B'2 

EF.AST='B'10 

EF.LCK='B'40 

EF.QUE='B'100 

EF.MDE»'B'200 



All non-control characters are out-of band 

All non-control DOB are include-QOB 

Reserved bit synonymous with TF.AST 

Reserved bit synonymous with AF.LCK 

TEP is queued 

TEP is marked for delete 
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Unbind Request packet (TMM ~> Network) 



.=E.VUCB+2 



E.VULN:'L' 



; Length of Unbind message 



Connect Reject notification packet (Network — > TMM) 



E.VRR;'L' 
E.VRLNr'L 



=E.VUC!B+2 

.BLKW 1 



; Reason for Rejection 
; Length of Reject message 



Disconnect Notification packet (Network — > TMM) 
.=E.VUCB+2 



E.VRDr'L' 
E.VDLN:'L' 



.BLKW 



; Reason for Disconnect 

; Length of Disconnect message 



Disconnect Complete packet (TMM ~> Network) 

.=E.vuas+2 



ETOCL: 


•L' 
.PSECT 




.IF NB LST 






.NLIST 




.IFF 








.MACRO 


EVNDF$ 




.ENDM 




.ENDC 








.ENDM 


EVNDF$ 



Length of Disconnect Complete message 



Turn listing back off 

If not listing, redefine 
macro to nothing 
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.MACRO F11DF$,L,B,SYSDEF 



VOLUME CONTROL BLOCK 



.=0 



.ASECT 



V.TRCT 


•L'.BLKW 1 




V.TYPE 


•L'.BLKB 1 






VT.FOR='B' 







VT.SL1='B' 


1 




VT.SL2='B' 


2 




VT.ANS='B' 


10 




VT.UNL='B' 


11 


V.VCHA 


■L'.BLKB 1 






VC.SLK='B' 


1 




VC.HLK='B' 


2 




VC.DEA='B' 


4 




VC.PUB='B' 


10 




VC.DUP='B' 


20 




VC.SIL='B' 


40 


V.LABL 


•L'.BLKB 14 




V.PKSR 


'L'.BLKW 2 




V.SLEN 


'L' 




V.IFWI 


'L' .BLKW 1 




V.FCB: 


L'.BLKW 2 




V.IBLB 


'L'.BLKB 1 




V.IBSZ 


'L'.BLKB 1 
.BLKW 1 




V.FMAX 


'L' .BLKW 1 




V.WISZ 


'L'.BLKB 1 




V.SBCL 


'L'.BLKB 1 




V.SBSZ 


'L' .BLKW 1 




V.SBLB 


'L'.BLKB 1 




V.FIEX 


'L'.BLKB 1 
.BLKW 1 




• WARI 


IING 





TRANSACTION COUNT 

VOLUME TYPE DESCRIPTOR 

Foreign volume structure 

Files- 11 Structure level 1 

Files- 11 Structure level 2 

ANSI labeled tape 

Unlabeled tape 

Volume characteristics 

Clear volume valid on dismount 

Unload the volume on dismount 

Deallocate the volume on dismount 

Set (clear) US. PUB on dismount 

Duplicate volume name; don't delete logicals 

Silent mode; suppress DISMOUNT COMPLETE message 

Volume label (ASCII) 

Pack serial number for error logging 

Length of short VCB 

INDEX FILE WINDOW 

FILE CONTROL BLOCK LIST HEAD 

INDEX BIT MAP 1ST LBN HIGH BYTE 

INDEX BIT MAP SIZE IN BLOCKS 

INDEX BITMAP 1ST LBN LOW BITS 

MAX NO. OF FILES ON VOLUME 

DEFAULT SIZE OF WINDOW IN RTRV PTRS 

VALUE IS < 128. 

STORAGE BIT MAP CLUSTER FACTOR 

STORAGE BIT MAP SIZE IN BLOCKS 

STORAGE BIT MAP 1ST LBN HIGH BYTE 

DEFAULT FILE EXTEND SIZE 

STORAGE BIT MAP 1ST LBN LOW BITS 



THE FOLLOWING CELLS OF THE VCB ARE ORDER DEPENDANT. 
THEY ARE RETURNED BY A READ ATTRIBUTES FUNCTION AND 
MUST BE KEPT CONTIGUOUS. IF NOT, THINGS MAY BREAK 
SOMEWHERE ALONG THE LINE. 



V.VOWN 
V.VPRO 
V.FPRO 
V.FRBK 
V.LRUC 



'L'.BLKW 
'L'.BLKW 
'L'.BLKW 
'L'.BLKB 
'L'.BLKB 
.BLKW 



VOLUME OWNER'S UIC 

VOLUME PROTECTION 

VOLUME DEFAULT FILE PROTECTION 

NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE 

COUNT OF AVAILABLE LRU SLOTS IN FCB LIST 

NUMBER OF FREE BLOCKS ON VOLUME LOW BITS 



WARNING 



THE ABOVE CELLS OF THE VCB ARE ORDER DEPENDANT. 
THEY ARE RETURNED BY A READ ATTRIBUTES FUNCTION AND 
MUST BE KEPT CONTIGUOUS. IF NOT, THINGS MAY BREAK 
SOMEWHERE ALONG THE LINE. 
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V.STS: 


L'.BLKB 1 






VS.IFW='B' 


1 




VS.BMW='B' 


2 


V.FFNU 


'L'.BLKB 1 




V.EXT: 


L'.BLKW 1 




V.HBLB 


'L'.BLKW 2 




V.HBCS 


'L'.BLKW 2 




V.LGTH 


'L' 





VOLUME STATUS BYTE, CONTAINING THE FOLLOWING 

INDEX FILE IS WRITE ACCESSED 

STORAGE BITMAP FILE IS WRITE ACCESSED 

FIRST FREE INDEX FILE BITMAP BLOCK 

POINTER TO VCB EXTENSION 

LBN of home block 

Home block checksums 

SIZE IN BYTES OF VCB 



MOUNT LIST ENTRY 

EACH ENTRY ALLOWS ACCESS TO A SPECIFIED USER FOR A NON-PUBLIC DEVICE 

TO ALLOW EXPANSION. ONLY THE ONLY TYPE CODE DEFINED IS "1" FOR 
DEVICE ACCESS BLOCKS 



.ASECT 



.=0 



M.LNK: 'L'.BLKW 1 
M.TYPE: 'L' .BLKB 1 
MT.MLS='B' 
M.ACC: 'L'.BLKB 1 
M.DEV: 'L'.BLKW 1 
M.TI: 'L'.BLKW 1 
M.LEN:'L' 



LINK WORD 

TYPE OF ENTRY 

Mounted volume user access list 

NUMBER OF ACCESSES 

DEVICE UCB 

ACCESSOR TI: UCB 

LENGTH OF ENTRY 



FILE CONTROL BLOCK 



.ASECT 



.=0 



F. LINK: 'L'.BLKW 1 
F.FNUM: 'L'.BLKW 1 
F.FSEQ: 'L'.BLKW 1 



F.FSQN: 
F.FOWN: 
F.FPRO: 
F.UCHA: 
F.SCHA: 
F.HDLB: 



.BLKB 1 
'L' -BLKB 1 
'L' .BLKW 1 
'L' .BLKW 1 
'L' .BLKB 1 
'L' .BLKB 1 
'L' .BLKW 2 



F. LBN: 'L'.BLKW 2 

F. SIZE: 'L'.BLKW 2 
F.NACS: 'L'.BLKB 1 
F.NLCK: 'L'.BLKB 1 
S.STBK='B'.-F.LBN 



FCB CHAIN POINTER 

FILE NUMBER 

FILE SEQUENCE NUMBER 

NOT USED 

FILE SEGMENT NUMBER 

FILE OWNER'S UIC 

FILE PROTECTION CODE 

USER CONTROLLED CHARACTERISTICS 

SYSTEM CONTROLLED CHARACTERISTICS 

FILE HEADER LOGICAL BLOCK NUMBER 

BEGINNING OF STATISTICS BLOCK 

LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS 

IF NON CONTIGUOUS 

SIZE OF FILE IN BLOCKS 

NO. OF ACCESSES 

NO. OF LOCKS 

SIZE OF STATISTICS BLOCK 
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F.STAT: 


•L' 




F.NWAC: 


'L'.BLKB 1 
.BLKB 1 






FC.WAC='B' 


lOOOOO 




FC.DIR='B' 


40000 




FC.CEF='B' 


20000 




FC.FCO='B' 


10000 


F.DREF: 


'L'.BLKW 1 




F.DRNM: 


■L'.BLKW 1 




F.FEXT: 


'L'.BLKW 1 




F.FVBN: 


'L'.BLKW 2 




F.LKL:' 


L' .BLKW 1 




F.WIN:' 


L' .BLKW 1 




F.LGTH: 


'L' 





FOB STATUS WORD 
NUMBER OF WRITE ACCESSORS 
STATUS BITS FOR FOB CONSISTING OF 
SET IF FILE ACCESSED FOR WRITE 
SET IF FCB IS IN DIRECTORY LRU 
SET IF DIRECTORY EOF NEEDS UPDATING 
SET IF TRYING TO FORCE DIRECTORY CONTIG 
DIRECTORY EOF BLOCK NUMBER 
1ST WORD OF DIRECTORY NAME 
POINTER TO EXTENSION FCB 
STARTING VBN OF THIS FILE SEGMENT 
POINTER TO LOCKED BLOCK LIST FOR FILE 
WINDOW BLOCK LIST FOR THIS FILE 
SIZE IN BYTES OF FCB 



WINDOW 



.ASECT 



.=0 



W.ACT:'L' 

W.BLKS:'L' 

W.CTL: 'L'.BLKW 

WI.RDV= 
WI.WRV= 
WI.EXT- 
WI.LCK= 
WI.DLK= 
WI.PND= 
WI.EXL= 
WI.WCK= 
W. IOC: 'L'.BLKB 
W.STS: 'L'.BLKB 

WS.MDL= 
W. FCB: 'L'.BLKW 
W.TCB: 'L'.BLKW 
W.UCB: 'L'.BLKW 
W.LKL: 'L'.BLKW 
W.WIN: 'L'.BLKW 

.IF 

.IF 



•B 
'B 
'B 
'B 
'B 
'B 
'B 
'B 

1 

1 
"B'l 

1 

1 

1 

1 

1 



400 

1000 

2000 

4000 

10000 

20000 

40000 

loooob 



NUMBER OF ACTIVE MAPPING POINTERS 

WHEN NO SECONDARY POOL 
BLOCK SIZE OF SECONDARY POOL SEGMENT 

WHEN SECONDARY POOL 
LOW BYTE = # OF MAP ENTRIES ACTIVE 
HIGH BYTE CONSISTS OF CONTROL BITS 

READ VIRTUAL BLOCK ALLOWED IF SET 

WRITE VIRTUAL BLOCK ALLOWED IF SET 

EXTEND ALLOWED IF SET 

SET IF LOCKED AGAINST SHARED ACCESS 

SET IF DEACCESS LOCK ENABLED 

WINDOW TURN PENDING BIT 

SET IF MANUAL UNLOCK DESIRED 

Data check all writes to file 
COUNT OF I/O THROUGH THIS WINDOW 
STATUS BYTE 

FILE DEFINED BY THIS WINDOW IS MARKED- FOR DELETE 
FILE CONTROL BLOCK ADDRESS 
TCB address of accessor 
Original UCB address of device 
POINTER TO LIST OF USERS LOCKED BLOCKS 
WINDOW BLOCK LIST LINK WORD 



NB.SYSDEF ; IF SYSDEF SPECIFIED IN CALL 
NDF,P$$WND ; IF SECONDARY POOL WINDOWS NOT ALLOWED 



NON-SECONDARY POOL WINDOW BLOCK 

IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK 
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS. 



W. VBN: 'L'.BLKB 1 
W.MAP:'L' 
W.WISZ: 'L'.BLKB 1 
.BLKW 1 
W.RTRV:'L' 



HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 

DEFINE LABEL WITH ODD ADDRESS TO CATCH BAD REFS 

SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

LOW ORDER WORD OF 1ST VBN MAPPED 

OFFSET TO 1ST RETRIEVAL POINTHl IN WINDOW 
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W.SLEN='B'-4 



.IFF 



Duauny definition to prevent incorrect reference 
(-4 when rounded "up" is a VERY large block) 

IF WINDOWS IN SECONDARY POOL 



SECONDARY POOL WINDOW CONTROL AND MAPPING BLOCK 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, LUTN2 POINTS 
TO A CONTROL BLOCK IN SYSTEM POOL WHICH CONTAINS THE 
FOLLOWING CONTROL FIELDS AND THE MAPPING INFORMATION 
FOR THE SECONDARY POOL WINDOW. 



W.MAP:fL'.BLKW 1 
W.SLEN:'L' 



ADDR TO THE MAPPING PTRS IN SECONDARY POOL 
Length of primary pool stub 



SECONDARY POOL WINDOW 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL 
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING 
FORMAT. 



.=0 



ASSUME W.CTL.O 



.BLKB 1 
W.USE:'L'.BLKB 1 
W.VBN:'L'.BLKB 1 
W.WISZ:'L'.BUB 1 

.BLKW 1 
W.RTRV:'L' 

.ENDC 

.ENDC 

LOCKED BLOCK LIST NODE 

.ASECT 



NUMBER OF ACTIVE MAPPING POINTERS 

STATUS OF BLOCK 

HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 

SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

LOW ORDER WORD OF 1ST VBN MAPPED 

OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 

END SECONDARY POOL WINDOW CONDITIONAL 

END SYSDEF CONDITIONAL 



L.LNK:'L'.BLKW 1 

L.WIlr'L'.BLKW 1 

L.VB1:"L'.BLKB 1 

L.CNT:'L'.BLKB 1 

.BLKW 1 
L.LKSZ:'L' 



LINK TO NEXT NODE IN LIST 
POINTER TO WINDOW FOR FIRST ENTRY 
HIGH ORDER VBN BYTE 
COUNT FOR ENTRY 
LOW ORDER VBN 



END OF DEFINITIONS 



.PSECT 

.MACRO F11DF$ 

.ENDM F11DF$ 

,ENDM F11DF$ 



X,Y,Z 
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.MACRO HDRDF$.L.B 



TASK HEADER OFFSET DEFIHITIOMS 



.ASECT 
.=0 

H.CSP:'L' 
H.HDLM:'L 
H.SMAP:'L 
H.DMAP:'L 
H.FMAP:'L 
H.CUIC:'L 
H.DUIC:'L 
H.IFS:'L' 
H.IPC:'L' 
H.ISP:'L' 
H.ODVA:'L 
H.ODVL:'L 
H.TKVA:'L 
H.TKVL:'L 
H.PFVA:'L 
H.FPVA:'L 
H.RCVA:'L 
H.EFSV: 'L 
H.FPSA:'L 
H.WNDr'L' 
H.DSW:'L' 
H.FCS:'L' 
H.FORT:'L 
H.OVLY:'L 
H.VEXT:'L 
H.SPRI:'L 
H.NML:'L' 
H.RRVA:'L 
H.X25:'L' 



H.LUTE: 
H.GARD: 
H.NLUN: 
H.LUN:' 



BLKW 

.BLKW 

.BLKB 

.BLKB 

.BLKW 

.BLKW 

.BLKW 

BLKW 

BLKW 

BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKW 



BLKW 1 



.BLKW 

BLKW 

BLKW 

BLKW 

.BLKW 

.BLKW 

.BLKW 

.BLKB 

BLKB 

.BLKW 

BLKB 

.BLKB 

.BLKW 
.BLKW 
.BLKW 1 
.BLKW 1 
BLKW 2 



CURRENT STACK POINTER 

HEADER LENGTH IN BYTES 

SUPERVISOR D SPACE OVERMAP MASK 

USER D SPACE OVERMAP MASK 

POINTER TO FAST MAP SECTION OF HDR 

CURRENT TASK UIC 

DEFAULT TASK UIC 

INITIAL PROCESSOR STATUS WORD (PS) 

INITIAL PROGRAM COUNTER (PC) 

INITIAL STACK POINTER (SP) 

ODT SST VECTOR ADDRESS 

ODT SST VECTOR LENGTH 

TASK SST VECTOR ADDRESS 

TASK SST VECTOR LENGTH 

POWER FAIL AST CONTROL BLOCK ADDRESS 

FLOATING POINT AST CONTROL BLOCK ADDRESS 

RECIEVE AST CONTROL BLOCK ADDRESS 

EVENT FLAG ADDRESS SAVE ADDRESS 

POINTER TO FLOATING POINT/EAE SAVE AREA 

POINTER TO NUMBER OF WINDOW BLOCKS 

TASK DIRECTIVE STATUS WORD 

FCS IMPURE POINTER 

FORTRAN IMPURE POINTER 

OVERLAY IMPURE POINTER 

WORK AREA EXTENSION VECTOR POINTER 

PRIORITY DIFFERENCE FOR SWAPPING 

NETWORK MAILBOX LUN 

RECEIVE BY REFERENCE AST CONTROL BLOCK ADDRESS 

FOR USE BY X25 SOFTWARE 

3 RESERVED BYTES 

POINTER TO LUT EXTENSION OF HEADER 
POINTER TO HEADER GUARD WORD 
NUMBER OF LUN'S 
START OF LOGICAL UNIT TABLE 



LENGTH OF FLOATING POINT SAVE AREA 



H.FPSL='B'25.*2 



WINDOW BLOCK OFFSETS 
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.=0 

W.BPCB:'L' 

W.BLVRl'L" 

W.BHVR: 

W.BATT: 

W.BSIZ: 

W.BOFF: 

W.BFPD: 

W.BNPD: 

W.BLPD: 

W.BL6H: 



.BLKW 
.BLKW 
.BLKW 



.BLKW 
.BLKW 
.BLKB 
.BLKB 



.BLKW 1 



.BLKW 1 



BIT DEFINITION FOR W.BLPD 

WB.NBP='B'20 
WB.BPS='B'40 



PARTITION CONTROL BLOCK ADDRESS 
LOW VIRTUAL ADDRESS LIMIT 
HIGH VIRTUAL ADDRESS LIMIT 
ADDRESS OF ATTACHMENT DESCRIPTOR 
SIZE OF WINDOW IN 32W BLOCKS 
PHYSICAL MEMORY OFFSET IN 32W BLOCKS 
FIRST PDR ADDRESS 
NUMBER OF PDR'S TO MAP 
CONTENTS OF LAST PDR 
LENGTH OF WINDOW DESCRIPTOR 



; CACHE BYPASS IS NOT DESIRED FOR THIS WINDOW 
; ALWAYS BYPASS THE CACHE FOR THIS WINDOW 



.PSECT 

.MACRO HDRDF$ X.Y 

.ENDM 

.ENDM 
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.MACRO HWDDF$.L.B,SYSDEF 

MACROS FOR DEFINING MAPPING REGISTER DEFINITIONS 

.MACRO CRESET NAM.ADDR 
$$$=0 

.REPT 8. 

CRENAM NAM,ADDR+<$$$*2>.\$$$ 

$$$s$$$+l 

.ENDR 
.ENDM 

.MACRO CRENAM NAM.ADDR.N 
'NAM"N'==ADDR 
.ENDM 



HARDWARE REGISTER ADDRESSES AND STATUS CODES 



MPCSR='B' 177746 
MPAR='B' 172100 
PIRQ='B' 177772 
PRO='B'0 
PR1='B'40 
PR4='B'200 
PR5-'B'240 
PR6='B'300 
PR7»'B'340 
PS='B' 177776 
SWR='B' 177570 
TPS='B' 177564 
KXCSRA='B' 177520 
KXCSRD-'B' 177630 
KXJQIR='B' 177532 
KXCSRF='B' 177534 
KXCSRH='B' 177536 



ADDRESS OF PDP-11/70 MEMORY PARITY REGISTER 

ADDRESS OF FIRST MEMORY PARITY REGISTER 

PROGRAMMED INTERRUPT REQUEST REGISTER 

PROCESSOR PRIORITY 

PROCESSOR PRIORITY 1 

PROCESSOR PRIORITY 4 

PROCESSOR PRIORITY 5 

PROCESSOR PRIORITY 6 

PROCESSOR PRIORITY 7 

PROCESSOR STATUS WORD 

CONSOLE SWITCH AND DISPLAY REGISTER 

CONSOLE TERMINAL PRINTER STATUS REGISTER 

KXJ CSR A 

KXJ CSR D 

KXJ qiR REGISTER 

KXJ CSR F 

KXJ CSR H 



KLN023 
KLN023 
KLN023 
KLN023 
KLN023 



EXTENDED ARITHMETIC ELEMENT REGISTERS 



.IF DF E$$EAE 



AC='B' 177302 
MQ='B' 177304 
SC='B' 177310 

.ENDC 



ACCUMULATOR 
MULTIPLIER-QUOTIENT 
SHIFT COUNT 



MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES 



.IF NB B 
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CRESET 


KINAR, 172340 


KERNEL I PAR'S 


CRESET 


KINDR, 172300 


KERNEL I PDR'S 


CRESET 


KDSAR, 172360 


KERNEL D PAR'S 


CREyKT 


KDSDR, 172320 


KERNEL D PDR'S 


CRESET 


SISAR. 172240 


SUPERVISOR I PAR'S 


CRESET 


SISDR, 172200 


SUPERVISOR I PDR'S 


CRESET 


SDSAR, 172260 


SUPERVISOR D PAR'S 


CRESET 


SDSDR, 172220 


SUPERVISOR D PDR'S 


CRESET 


UINAR, 177640 


USER I PAR'S 


CRESET 


UINDR. 177600 


USER I PDR'S 


CRESET 


UDSAR. 177660 


USER D PAR'S 


CRESET 


UDSDR. 177620 


USER D PDR'S 


.ENDC 






.IF NB 


SYSDEF 




.IF DF 


K$$DAS 




CRESET 


KISAR. 172360 


KERNEL D PAR'S 


CRESET 


KISDR, 172320 


KERNEL D PDR'S 


.IFF 






CRESET 


KISAR, 172340 


KERNEL I PAR'S 


CRESET 


KISDR. 172300 


KERNEL I PDR'S 


.ENDC 






.IF DF 


U$$DAS 




CRESET 


UISAR, 177660 


USER D PAR'S 


CRESET 


UISDR. 177620 


USER D PDR'S 


.IFF 


; DF U$$DAS 




CRESET 


UISAR, 177640 


USER I PAR'S 


CRF,SET 


UISDR, 177600 


USER I PDR'S 


.ENDC 


; DF U$$DAS 





.ENDC 



UBMPR= 
CM0DE= 
PMODE= 
CSM0D& 
PSMODE^ 
SRO='B 
SR3='B 
CPUERR: 
MEMERR^ 
MEMCTL 



B' 170200 
B' 140000 
B' 30000 

,= 'B '40000 
■B' 10000 
177572 
172616 
•B' 177766 
'B' 177744 

,= 'B' 177746 



UNIBUS MAPPING REGISTER 

CURRENT MODE FIELD OF PS WORD 

PREVIOUS MODE FIELD OF PS WORD 

CURRENT MODE = SUPERVISOR PS WORD BITS 

PREVIOUS MODE = SUPERVISOR PS WORD BITS 

SEGMENT STATUS REGISTER 

SEGMENT STATUS REGISTER 3 

CPU ERROR REGISTER 

MEMORY SYSTEM ERROR REGISTER 

MEMORY CONTROL REGISTER 



DEFINE THE LOCATIONS USED 
FOR XT SYSTEMS 



IN THE NON-VOLATIL RAM (NVR) 
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N.KEY='B' 173054 
N.UPT='B' 173064 
N.DZA='B' 173074 
N.DWA='B' 173104 
N.DAY='B' 173114 
N.M0N='B'173116 
N.YEA='B' 173120 



NUMBER OF KEYS PRESSED 

UPTIME IN MINUTES 

NUMBER OF I /OS DONE ON THE DZ 

NUMBER OF I /OS DONE ON THE DW 

DATE THAT THE KVR WAS LAST INITIALIZED 



; + 

: FEATURE 


SYMBOL 


FE 


EXT= 


B 


1 


FE 


MUP= 


B 


2 


FE 


EXV= 


B 


4 


FE 


DRV= 


B 


10 


FE 


PLA= 


B 


20 


FE.CAL= 


B 


40 


FE 


PKT= 


B 


100 


FE 


EXP= 


B 


200 


FE 


LSI= 


B 


400 


FE 


OFF= 


B 


1000 


FE 


FDT= 


B 


2000 


FE 


X25= 


B 


4000 


FE 


DYM= 


B 


10000 


FE 


CEX= 


B 


20000 


FE 


MXT= 


B 


40000 


FE 


NLG= 


B 


100000 



22-BIT EXTENDED MEMORY SUPPORT 

MULTI-USER PROTECTION SUPPORT 

EXECUTIVE IS SUPPORTED TO 20K 

LOADABLE DRIVER SUPPORT 

PLAS SUPPORT 

DYNAMIC CHECKPOINT SPACE ALLOCATION 

PREALLOCATION OF I/O PACKETS 

EXTEND TASK DIRECTIVE SUPPORTED 

PROCESSOR IS AN LSI-11 

PARENT/OFFSPRING TASKING SUPPORTED 

FULL DUPLEX TERMINAL DRIVER SUPPORTED 

X.2e CEX IS LOADED 

DYNAMIC MEMORY ALLOCATION SUPPORTED 

COM EXEC IS LOADED 

MCR EXIT AFTER EACH COMMAND MODE 

LOGINS DISABLED - MULTI-USER SUPPORT 



FEATURE MASK DEFINITIONS (SECOND WORD) 



F2.DAS= 


B' 


F2.LIB= 


B' 


F2.MP='I 


)'4 


F2.EVT= 


B' 


F2.ACN= 


B' 


F2.SDW= 


B' 


F2.P0L= 


B' 


F2.WND= 


B' 


F2.DPR= 


B' 


F2.IRR= 


B- 


F2.GGF= 


B' 


F2.RAS= 


B' 


F2.AHR= 


B' 


F2.RBN= 


B' 


F2.SWP= 


B' 


F2.STP= 


B' 



1 

2 

10 

20 

40 

100 

200 

400 

1000 

2000 

4000 

10000 

20000 

40000 

100000 



KERNEL DATA SPACE SUPPORTED 

SUPERVISOR MODE LIBRARIES SUPPORTED 

SYSTEM SUPPORTS MULTIPROCESSING 

SYSTEM SUPPORTS EVENT TRACE FEATURE 

SYSTEM SUPPORTS CPU ACCOUNTING 

SYSTEM SUPPORTS SHADOW RECORDING 

SYSTEM SUPPORTS SECONDARY POOLS 

SYSTEM SUPPORTS SECONDARY POOL FILE WINDOWS 

SYSTEM HAS A SEPARATE DIRECTIVE PARTITION 

INSTALL, RUN. AND REMOVE SUPPORT 

GROUP GLOBAL EVENT FLAG SUPPORT 

RECEIVE/SEND DATA PACKET SUPPORT 

ALT. HEADER REFRESH AREA SUPPORT 

ROUND ROBIN SCHEDULING SUPPORT 

EXECUTIVE LEVEL DISK SWAPPING SUPPORT 

EVENT FLAG MASK IS IN THE TCB(1=YES) 



THIRD FEATURE MASK SYMBOL DEFINITIONS 
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FS.CRA^ 

FS.XCRi 

F3.EI& 

F3.STM^ 

F3.UD& 

FS.PRO^ 

FS.XHR^ 

F3.AST= 

F3.11S= 

F3.CLI- 

F3.TCM^ 

F3.PMN= 

F3.WAT 

F3.RLKi 

F3.SHF= 



•B'l 

■B'2 

•B'4 

•B'lO 

•B'20 

■B'40 

■B'lOO 

■B'20O 

'B'40O 

'B'lOOO 

'B'20O0 

'B'40O0 

'B' 10000 

•B' 20000 

'B'40000 



SYSTEM SPONTANEOUSLY CRASHED (1=YES) 
SYSTEM CRASHED FROM XDT (1=YES) 
SYSTEM REQUIRES EXTENDED INSTRUCTION SET 
SYSTEM HAS SET SYSTEM TIME DIRECTIVE 
SYSTEM SUPPORTS USER DATA SPACE 
SYSTEM SUPPORTS SEC. POOL PROTO TCBS 
SYSTEM SUPPORTS EXTERNAL TASK HEADERS 
SYSTEM HAS AST SUPPORT 
RSX-llS SYSTEM 
MULTIPLE CLI SUPPORT 

SYSTEM HAS SEPARATE TERMINAL DRIVER POOL 
SYSTEM SUPPORTS POOL MONITORING 
SYSTEM HAS WATCHDOG TIMER SUPPORT 
SYSTEM SUPPORTS RMS RECORD LOCKING 
SYSTEM SUPPORTS SHUFFLER TASK 



FOURTH FEATURE MASK BITS 



F4.CXDi 
F4.XT= 
F4.ERL= 
F4.PTY= 
F4.DVN^ 
F4.LCD^ 
F4.NIMi 
F4.CHE= 
F4.L0G= 
F4.NAM= 
F4.FMP= 
F4.DCL= 
F4.DDS: 
F4.ACD= 
r4.NCT= 
F4.LSD= 



= 'B'l 

B'2 

■'B'4 
'B'lO 

■'B'20 

■•B'40 

i'B'lOO 
'B'200 
'B'400 

•'B'lOOO 
"B'20O0 
■B'4000 
'B' 10000 
'B' 20000 
•B' 40000 
'B' 100000 



FIFTH FEATURE MASK BITS 



F5.PR0= 
F5.DFB= 
F5.RTB= 
F5.0DB= 
F5.XDJ= 
F6.NSY= 
F5.NC0= 
F5.RTK= 
F5.RDR= 
F5.RLG= 



'B'l 

'B'2 

'B'4 

'B'lO 

•B'20 

'B'40 

■B'lOO 

'B'200 

■B'400 

'B'lOOO 



COMM EXEC IS DEALLOCATED (NON-I/D ONLY) 
SYSTEM IS AN XT SYSTEM (1=YES) 
SYSTEM SUPPORTS ERROR LOGGING (1=YES) 
SYSTEM SUPPORTS PARITY MEMORY (1=YES) 
SYSTEM SUPPORTS DECIMAL VERSIONS (1=YES) 
SYSTEM SUPPORTS LOADABLE CRASH (1=YES) 
SYSTEM SUPPORTS DELETED TASK IMAGES (1=YES) 
SYSTEM SUPPORTS DISK DATA CACHING (1=YES) 
SYSTEM SUPPORTS LOGICAL NAMES (1=YES) 
SYSTEM SUPPORTS NAMED DIRECTORIES (1=YES) 
SYSTEM SUPPORTS FAST MAP DIRECTIVE 
DCL IS DEFAULT CLI (1=YES) 
NAMED DIRECTORY MODE IS THE DEFAULT (1=YES) 
SYSTEM SUPPORTS ACD'S (1=YES) 
SYSTEM HAS NCT SUPPORT (1=YES) 
SYSTEM HAS LUT SCAN DISABLED 



SYSTEM SUPPORTS PROFESSIONAL 3XX SERIES 

SYSTEM HAS DEFERRED BINDING 

RUN TIME BINDING 

USER CAN OVERRRIDE DEFERRED BINDING 

XDT IS USING KXJ INTERFACE FOR I/O 

NO LOCAL SYSTEM DISK 

NO LOCAL CONSOLE 

REMOTE TASK SERVICES 

REMOTE DIRECTORY STORAGE 

REMOTE LOGICAL SUPPORT 



KLNOll 
KLNOll 
KLNOll 
KLNOll 
KLNOll 

KLNOll 
KLNOll 
KLNOll 
KLN018 
KLNOll 
KLNOll 
KLNOll 
KLNOll 
KLNOll 



HARDWARE FEATURE MASK BIT DEFINITIONS 



HF.CIS.HF.FPP DEFINED AS SIGN BITS FOR RUN TIME SPEED 
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HF.UBM='B'l 

HF.EIS='B'2 

HF.QB='B'4 

HF.DSP='B'10 

HF.SVni='B'20 

HF.KXJ='B'40 

HF.RMT='B'100 

HF.CIS='B'200 

HF.FPP='B' 100000 



PROCESSOR HAS A UNIBUS MAP (1=YES) 

PROCESSOR HAS EXTENDED INSTRUCION SET 

SYSTEM HAS A QBUS (1=YES) 

HARDWARE SUPPORTS DATA SPACE 

SYSTEM HAS SWITCH REGISTER HARDWARE PRESENT 

PROCESSOR TYPE IS KXJll 

REMOTE SERVICES REQUIRED 

PROCESSOR SUPPORTS COMMERCIAL INSTRUCTION SET 

(1=PR0C. HAS NO FLOATING POINT UNIT) 



LBM050 
KLNOll 
KLNOll 



SECOND HARDWARE FEATURE MASK BIT DEFINITIONS 
THIS WORD IS RESERVED FOR XT HARDWARE FEATURES 



H2.NVR='B'l 

H2.INV='B'2 

H2.CLK='B'4 

H2.ITF='B'10 

H2.PR0='B'2O 

H2.BRG='B' 100000 



XT NON-VOLATILE RAM PRESENT (1=YES) 

NON-VOLATILE RAM IS INVALID (1=YES) 

XT CLOCK IS PRESENT (1=YES) 

INVALID TIME FORMAT IN NON-VOLATILE RAM (1=YES) 

RUNNING ON PR0/3XX HARDWARE 

XT BRIDGE MODULE PRESENT (1=YES) 



SYSGEN FEATURE SELECTIONS MASK. THIS IS INTENDED TO RECORD IN A 

BIT MASK THE CHOICES THE USER HAS MADE AT SYSGEN TIME. FEATURES WILL 

BE LISTED HERE WHEN THEY ARE BEING RECORDED FOR OUR INFORMATIONAL 

PURPOSES ONLY. THEY CANNOT BE TESTED LIKE BITS IN THE FEATURE MASK 

SINCE THIS ONLY EXISTS IN THE RSXllM.STB FILE. NO BITS IN MEMORY 

ARE USED. THEY ARE ONLY INTENDED TO BE PRINTED FROM THE STB FILE BY CDA. 



SF.STD='B'l 
SF.PGN='B'2 



; STANDARD EXEC SELECTED 

; SYSTEM WAS PRE-GENERATED (EX. RL02/RC25 SYSTEM) 



MULTIPROCESSOR STATUS TABLE DEFINITIONS (TEMPORARY) 



MP. CRH='B' 100000 
MP.PWF='B' 40000 
MP.RSM=='B'20000 
MP. NOP='B' 10000 
MP.STP='B'4 
MP.INT='B'7777 

.MACRO 

.ENDM 

.ENDM 



CRASH PROCESSOR IMMEDIATELY 

POWERFAIL ON ONE CPU 

RESET INTERRUPT MASKS 

NOP FUNCTION FOR TRANSMISSION CHECK 

STOP PROCESSOR IN ORDERLY FASHION 

BIC MASK FOR INTERRUPT LVL FUNCTIONS 



HWDDF$ X.Y.Z 
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.MACRO ITBDF$ L.B.SYSDEF 



INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS 





.IF DF 


A$$TRP 






.MCALL 
PKTDF$ 


PKTDF$ 


DEFINE AST BLOCK OFFSETS 




.ENDC 






X.LNK: 
X.JSR: 
X.PSW: 

X.ISR: 
X.FORK 


.ASECT 
.=0 
'L' .BLKW 
'L' JSR 
'L< .BLKB 

.BLKB 
'L' .BLKW 
:'L' 
.BLKW 
.BLKW 
.BLKW 
.BLKW 


1 

R5.ffl#0 
1 
1 

1 

1 
1 
1 

1 


LINK WORD FOR ITB LIST STARTING IN TCB 

CALL $INTSC 

LOW BYTE OF PSW FOR ISR 

UNUSED 

ISR ENTRY POINT (APR5 MAPPING) 

FORK BLOCK 

THREAD WORD 

FORK PC 

SAVED R5 

SAVED R4 




.IF DF 


M$$MGE 




X.REL: 


'L' .BLKW 
.ENDC 


1 


RELOCATION BASE FOR APR5 


X.DSI: 
X.TCB: 


'L' .BLKW 
•L' .BLKW 


1 
1 


ADDRESS OF DIS.INT. ROUTINE ' 
TCB ADDRESS OF OWNING TASK 




.IF NB 


SYSDEF 






.IF DF 


A$$TRP 




X.AST: 


.BLKW 
•L' .BLKB 

.ENDC 


1 
A.PRM 


A.DQSR FOR AST BLOCK 
AST BLOCK 


X.VEC: 

X.VPC: 

X.LEN: 


•L' .BLKW 

'L' .BLKW 
'L' 

.ENDC 


1 
1 


VECTOR ADDRESS (IF AST SUPPORT. 
THIS IS FIRST AND ONLY AST PARAMETER) 
SAVED VECTOR PC 
LENGTH IN BYTES OF ITB 




.PSECT 
.MACRO 
.ENDM 
.ENDM 


ITBDF$ X,Y,Z 

ITBDF$ 

ITBDFS 
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.MACRO KRBDF$,L,B,SYSDEF 



CONTROLLER REQUEST BLOCK (KRB) 

THE CONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A DEVICE 
CONTROLLER. EXACTLY ONE KRB EXISTS FOR EVERY DEVICE CONTROLLER 
IN AN RSX-11M+ SYSTEM. THE KRB CONTAINS CERTAIN DEVICE STATUS 
INCLUDING THE CSR AND VECTOR ADDRESS FOR THE CONTROLLER. 



=177770 



K.PRM: 
K.PRI: 
K.VCT: 
K.CON: 
K.IOC: 
K.STS: 
K.CSR: 

NOTE 

K.OFF: 
K.HPU: 

K.OWN: 
K.CRQ: 
K.URM: 
K.FRK: 



.ASECT 

.BLKW 
.BLKB 
.BLKB 
.BLKB 
.BLKB 
.BLKW 
.BLKW 



DEVICE DEPENDANT PARAMETER WORD 

CONTROLLER PRIORITY 

INTERRUPT VECTOR ADDRESS 

CONTROLLER INDEX WITHIN THE SYSTEM 

CONTROLLER I/O COUNT 

CONTROLLER STATUS 

ADDRESS OF CONTROL STATUS REGISTER 



K.CSR MUST BE THE ZERO OFFSET! 



L' .BLKW 

L' .BLKB 

.BLKB 

L' .BLKW 

L' .BLKW 

L' .BLKW 

L' .BLKW 



OFFSET TO UCB/UMR/RHBAE TABLE 
HIGHEST PHYSICAL UNIT NUMBER 
UNUSED BYTE 
OWNER OF CONTROLLER 
CONTROLLER REQUEST QUEUE 
CONTROLLER UNIBUS RUN MASK 
POSSIBLE KRB FORK BLOCK 



OFFSETS FOR THE KRB EXTENSION REACHED BY ADDING (K.OFF) TO 
THE STARTING ADDRESS OF THE KRB. 



DEFINE OFFSETS IN SCB/KRB FOR DISK MSCP CONTROLLERS 



.=-20. 

KE.UMH:'L'.BLKW 2 
KE.UMC:'L'.BLKW 1 

.=177776 

KE.RHB:'L'.BLKW 1 



;LIST HEAD FOR UMR WAITING ASSIGNMENT BLOCK (S) 

; COUNT OF AVAILABLE UMR WAITING ASSIGNMENT BLOCK (S) 



; OFFSET TO RHBAE REGISTER (IF ANY) 



WHEN ONE ADDS (K.OFF) TO THE KRB ADDRESS, IT YIELDS AN ADDRESS 
WHICH POINTS TO HERE. 



KE.UCB:'L'.BLKW 1 
.PSECT 

+ 



; OFFSET TO UCB TABLE (IF KS.UCB SET) 



CONTROLLER REQUEST BLOCK (KRB) STATUS BIT DEFINITIONS 
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KS.OFL= 
KS.MOF= 
KS.UOP= 
KS.MBC= 
KS.SDX= 
KS.POE= 
KS.UCB= 
KS.DIP= 
KS.PDF= 
KS.EXT= 
KS.SLO= 



'B'l 

'B'2 

•B'4 

■B'lO 

•B'20 

'B'40 

■B'lOO 

'B'200 

'B'400 

'B'lOOO 

'B'20O0 



CONTROLLER OFFLINE (1=YES) 
CONTROLLER MARKED FOR OFFLINE (1=YES) 
SUPPORTS OVERLAPPED OPERATION (1=YES) 
DEVICE IS MASSBUS CONTROLLER (1=YES) 
SEEKS ALLOWED DURING DATA XFERS (i=YES) 
PARALLEL OPERATION ENABLED (1=YES) 
UCB TABLE PRESENT (1=YES) 
DATA TRANSFER IN PROGRESS (1=YES) 
PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY (1=YES) 
EXTENDED 22-BIT UNIBUS CONTROLLER (1=YES) 
CONTROLLER IS SLOW COMING ONLINE (1=YES) 



DEFINE THE CONTIGUOUS SCB OFFSETS 



.ASECT 



=177762 



S.PRI: 


'L' .BLKB 1 


S.VCT: 


•L' .BLKB 1 


S.CON: 


■L' ,BLKB 1 




.BLKB 1 




.BLKW 1 


S.CSR: 


•L' .BLKW 1 




.BLKW 1 




.BLKB 1 




.BLKB 1 


S.OWN: 


■L' .BLKW 1 



CONTROLLER PRIORITY 
INTERRUPT VECTOR ADDRESS 
CONTROLLER INDEX 



; CONTROL AND STATUS REGISTER 



; DISTRIBUTED CNTBL 



SUBCONTROLLER REQUEST BLOCK (KRBl) 

THE SUBCONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A DEVICE 
SUBCONTROLLER. EXACTLY ONE KRBl EXISTS FOR EVERY DEVICE SUBCONTROLLER 
IN AN RSX-11M+ SYSTEM. 



.=-4 
Kl.CON: 

Kl.STS: 
Kl.MAS: 



.ASECT 



'L'.BLKB 1 

.BLKB 1 

'L'.BLKW 1 

'L'.BLKW 1 



SUBCONTROLLER INDEX WITHIN THE SYSTEM 

UNUSED BYTE 

SUBCONTROLLER STATUS 

UCB ADDRESS OF THE MASTER UNIT 



NOTE: Kl.MAS MUST BE THE ZERO OFFSET 



Kl.OWN: 
Kl.CRQ: 
Kl.UCB: 



'L'.BLKW 1 
'L'.BLKW 2 
'L' 

.PSECT 



OWNER OF SUBCONTROLLER 
SUBCONTROLLER REQUEST QUEUE 
START OF THE UCB TABLE (IF ANY) 



.MACRO KRBDF$.X.Y,Z 
.ENDM 

.ENDM 
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•MACRO LCBDF$,L.B 

h 

LOGICAL ASSIGNMENT CONTROL BLOCK 

THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO ASSOCIATE A 
LOGICAL NAME WITH A PHYSICAL DEVICE UNIT. LCB'S ARE LINKED TOGETHER 
TO FORM THE LOGICAL ASSIGNMENTS OF A SYSTEM. ASSIGNMENTS MAY BE ON 
A SYSTEM WIDE OR LOCAL (TERMINAL) BASIS. 







.ASECT 


^ = 


=0 




L 


LNK: 


L' .BLKW 1 ; 


L 


NAM: 


L' .BLKW 1 ; 


L 


UNIT 


•L' .BLKB 1 ; 


L 


TYPE 


'L' .BLKB 1 ; 


L.UCB: 


L' .BLKW 1 ; 


L 


ASG: 


L' .BLKW 1 ; 


L 


LGTH= 


='B'.-L.LNK ; 
.PSECT 

.MACRO LCBDF$,X.Y 

.ENDM 
.ENDM 



LINK TO NEXT LCB 

LOGICAL NAME OF DEVICE 

LOGICAL UNIT NUMBER 

TYPE OF ENTRY (0=SYSTEM WIDE) 

TI UCB ADDRESS 

ASSIGNMENT UCB ADDRESS 

LENGTH OF LCB 



C-42 System Data Structures and Symbolic Definitions 



LNMDF$ 



.MACRO LNMDF$,L,B,SYSDEF 
.SAVE 

LOGICAL NAME BLOCK (LNB) 



.ASECT 



■L' 
•L' 
■L' 
•L' 
'L' 
'L' 
'L' 
'L' 
'L' 
'L' 
'B' 



.BLKW 
.BLKB 
.BLKB 
.BLKB 
.BLKB 

.BLKW 
.BLKB 
.BLKB 



.=0 

L.NLNK: 
L.NTBL: 
L.NBLK: 
L.NSTS: 
L.NGRP: 
L.NUCB: 
L.NTCB: 
L.NLNS: 
L.NENS: 
L.NNAM: 
L.NHSZ= 
+ 

TABLE NUMBER DEFINITIONS 

LT.SYS='B'0 
LT.GRP='B'l 
LT.USR='B'2 
LT.TSK='B'3 
LT.SES='B'4 
LT.INV='B'6 
LT.APP='B'5 
+ 
STATUS BIT DEFINITIONS 

LS.TRM='B'l 
LS.PRV='B'2 
+ 
STANDARD BLOCK TYPE DEFINITIONS 



LINK WORD 

LOGICAL TABLE NUMBER 

LOGICAL NAME BLOCK TYPE 

STATUS WORD 

CREATOR GROUP NUMBER (GROUP TABLE ONLY) 

CREATOR UCB (USER) OR TCB (TASK) 
SIZE OF LOGICAL NAME STRING 
LENGTH OF EQUIVALENCE NAME STRING 
VARIABLE LENGTH LOGICAL NAME STRING 
SIZE OF LOGICAL NAME BLOCK HEADER 



SYSTEM WIDE LOGICAL NAME 

GROUP LOGICAL NAME (UIC GROUP NUMBER) 

USER SPECIFIC LOGICAL NAME (P/OS) 

TASK SPECIFIC LOGICAL NAME 

SESSION WIDE LOGICAL NAME (RSX LOCAL/LOGIN) 

TASK/PROCESS INVOCATION LOGICAL NAME 

APPLICATION WIDE LOGICAL NAME 



; LOGICAL HAS A TERMINAL STATUS 

;USER MUST BE PRIVILEGED TO DELETE LOGICAL 



LB.LOC='B'l 
LB.L06='B'2 

+ 
INHIBIT MASK BIT DEFINITIONS 

IN.TSK='B'l 
IN.SES='B'20 
IN.GRP='B'4 
IN.SYS='B'10 



; BLOCK NUMBER FOR A STANDARD LOGICAL CREATION 
; SPECIAL BLOCK NUMBER FOR LOGIN LOGICALS 



INHIBIT THE TASK LOGICAL TABLE 
INHIBIT THE SESSION LOGICAL TABLE 
INHIBIT THE GROUP LOGICAL TABLE 
INHIBIT THE SYSTEM LOGICAL TABLE 



CONTEXT BLOCK OFFSETS FOR DDS STORAGE 



.=0 

C.REF:'L' 

C.DDSL:'L' 

C.CUIC:'L' 

C.FIXL='B' 

C.DDS:'L' 



.BLKB 1 
.BLKB 1 
.BLKW 1 



REFERENCE COUNT 

LENGTH OF DDS 

UIC FOR CLOCK BLOCK PROPAGATION 

FIXED LENGTH OF CONTEXT BLOCK 



System Data Structures and Symbolic Definitions C-43 



LNMDF$ 



Definitions of the offsets for the parse block. 

NOTE: 

These definitions are the same as those in DRPFN.MAC. 
Any change here must be reflected there. 



.=0 

0$STAT: 

0$FLAG: 

0$NODS : 

0$NODA: 

0$DEVS : 

OiDEVA: 

0$DIRS : 

0$DIRA: 

0$NAMS: 

0$NAMA: 

0$TYPS: 

0$TYPA: 

0$VERS: 

0$VERA: 

0$TRLS: 

0$TRLA: 

0$ACCS: 

0$ACCA: 

0$LTYP : 



.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKW 




.BLKB 




.BLKB 





0$PLEN='B' 



; Status value 

; Output flags 

;Node spec size 

;Node spec address 

; Device spec size 

; Device spec address 

;Dir spec size 

;Dir spec address 

;Nam spec size 

;Nam spec address 

;Typ spec size 

;Typ spec address 

; Version spec size 

; Version spec address 

; Trailing portion size 

; Trailing portion address 

;Acces8 spec size 

; Access spec address 

; Logical type 

; Reserved 

;Length of parse block 



Definitions of the values for the parse block status field 0$STAT. 

NOTE: 

These definitions are the same as those in RMSLIB.MLB. 
Any change here must be reflected there. 

; Operation successful 

; Error in node name 

;Bad device, or inappropriate device typ 

; Error in directory name 

; Error in file name 

; Error in file type extension 

; Error in version number 

; Expanded string area too short 

;Extraneous field detected during parse 

; Illegal logical expansion 

; Logical exceeded recursion count 

;bad size 



suisuc 




•B 


1 


ER$NOD 




•B 


175550 


ER$DEV 




'B 


177100 


ER$DIR 




'B 


177060 


ER$FNM 




'B 


176420 


ER$TYP 




•B 


174540 


ER$VER 




'B 


174460 


ER$ESS 




■B 


176640 


ER$XTR 




'B 


174340 


ER$6Eq 




■B 


177510 


ER$TRN 




■B 


174550 


ER$FTB 




•B 


176364 
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Definitions of the flag bits in the parse block flags field 0$FLAG. 

NOTE: 

These definitions are the same as those in RMSLIB.MLB. 
Any change here must be reflected there. 



Node present 
Device present 
Directory present 
Quoted filename present 
Filename present 
File type present 
File version present 
Wildcard character present 
Wild directory 
Wild filename 
Wild file type 
Wild file version 
Suppress system defaulting 



FS$NOD 


='B'400 


FS$DEV 


='B'200 


FS$DIR 


='B'100 


FS$quo 


='B'2000 


FS$IIAM 


= 'B'4 


FS$TYP 


= 'B'2 


FS$VER 


= 'B'l 


FS$WCH 


='B'4000 


FS$WDI 


='B'1000 


FS$WNA 


='B'40 


FS$WTY 


='B'20 


FS$WVE 


='B'10 


FS$NDF 


='B' 10000 



Definitions of the values for the parse block logical type field 0$LTYP. 

NOTE: 

These definitions are the same as those in DRPFN.MAC. 
Any change here must be reflected there. 



P.LNON ='B'0 

P.LNAM ='B'l 

P.LDEV ='B'2 

P.LNOD ='B'3 



;No logical name present 

;The filename may be a logical name 

;The device name may be a logical name 

;The node specification may be a logical name 



.RESTORE 

.MACRO LNMDF$ X,Y,Z 

.ENDM 

.ENDM 
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.MACRO 
.ASECT 



MTADF$.L,B 



ANSI MAGTAPE SPECIFIC DATA STRUCTURES 

VOLUME SET CONTROL BLOCK OFFSET DEFININTIONS (VSCB) 

VOLUME SET AND PROCESS CONTROL SECTION 



.=0 






V.TCNT: 


•L' 


.BLKW 1 


V.TYPE: 


'L' 


.BLKB 1 


V.VCHA: 


•L' 


.BLKB 1 


V.LABL: 


'L' 


.BLKB 12. 


V.NXT:' 


L' 


.BLKW 1 


V.MVL:' 


L< 


.BLKW 1 


V.UVL;' 


L' 


.BLKW 1 


V.ATL;' 


l< 


.BLKW 1 


V.UCB:'l 


l< 


.BLKW 1 


V.RVOL: 


>L> 


.BLKB 1 


V.MDU:'] 


L' 


.BLKB 1 


V.TCHR: 


'L' 


.BLKW 1 


V.SEQN: 


'L- 


.BLKW 1 


V.SECN: 


'L' 


.BLKW 1 


V.TPOS: 


'L' 


.BLKB 1 


V.PSTA: 


'L' 


.BLKB 1 


V.TIMO: 


'L' 


.BLKW 1 


V.STAT: 


'L' 


.BLKW 


V.TRTB: 


'L' 


.BLKB 1 


V.EFTV: 


'L' 


.BLKB 1 


; LABEL 


DATA SECTION 


V.BLKL: 


•L' 


.BLKW 1 


V.RECL: 


'L' 


.BLKW 1 


V.FNAM: 


•L' 


.BLKW 3 


V.FTYP: 


L' 


.BLKW 1 


V.FVER: 


L' 


.BLKW 1 


V.CDAT: 


L' 


.BLKW 2 


V.EDAT: 


L" 


.BLKW 2 


V.BLKC: 


L' 


.BLKW 2 


V.RTYP: 


L' 


.BLKB 1 


V.FATT: 


L' 


.BLKB 1 
.BLKB 30. 


; NULL \ 


IflNDOW SECTIO 


V.WIND: 


'L' 


.BLKW 4. 




;***:|c* 


V.MST2: 


L' 


.BLKW 1 


V.FABY: 


L' 


.BLKB 1 
.BLKB 1 


V.ANSN: 


L' 


.BLKB 17. 


V.BOFF: 


L' 


.BLKB 1. 


V.DENS: 


L' 


.BLKB 1. 


V.DRAT: 


L' 


.BLKB 1. 


V.DBLK: 


L' 


.BLKW 1. 



TRANSACTION COUNT 
VOLUME TYPE DESCRIPTOR 
VOLUME CHARACTERISTICS 
FILE SET ID (FIRST SIX BYTES) 
PTR TO NEXT VSCB NODE 
PTR TO MOUNTED VOL LIST 
PTR TO UNMOUNTED VOL LIST 
ATL ADDR OF ACCESSING TASK 

TCB IN RSXllM 
ADDR OF CURRENT UCB OR PUD 
CURRENT RELATIVE VOL # 
MOUNT MODE BYTE 

UINT CHAR. FOR ALL UNITS USED FOR VOL SET 
CURRENT FILE SEQUENCE # 
CURRENT FILE SECTION # 
POSITION OF TAPE IN TM'S TO NXT HDRi 
PROCESS STATUS BYTE 
BLOCKED PROCESS TIMEOUT COUNTER 

STATUS WORDS USED BY COMMAND 
EXECUTION MODULES 
TRANSLATION CONTROL BYTE 
FOR MAG TO RETURN IE. EOF. EOT. EOV 



BLOCK LENGTH 

RECORD LENGTH 

FILE NAME 

FILE TYPE 

FILE VERSION # 

CREATION DATE 

EXPRIATIDN DATE 

BLOCK COUNT FOR FILE SECTION 

RECORD TYPE 

FILE ATTRIBUTES FOR CARRIAGE CONTROL 

REMAINDER OF FILE ATTRIBUTES 



NULL WINDOW 

MAGTAPE STATUS BITS 

FILE ACCESSIBILITY BYTE (HDRI) 

SPARE 

ANSI 17 CHARACTER FILE NAME 

BUFFER OFFSET 

REQUESTED UNIT DENSITY 

DEFAULT RECORD ATTRIBUTES 

DEFAULT BLOCK SIZE 
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V.DRECi'L' .BLKW 1. 

S.VSCB='B' . 

.PSECT 



; DEFAULT RECORD SIZE 
iSIZE OF VSCB 



DEFINE OFFSETS INTO NULL WINDOW SECTION 



.ASECT 



W.CTL:' 
V.WINC= 
.PSECT 



.BLKW 1 ; CONTROL WORD IN WINDOW 
•V.WIND+W.CTL ; CNTRL WORD IN NULL WINDOW 

; RELATIVE TO THE VSCB 



MOUNTED VOLUME LIST OFFSET DEFININTIONS (MVL) 



.ASECT 



.=0 







.IF DF 


M 


NXT: 


L' .BLKW 1 
.ENDC 


M 


UIC: 


L' .BLKW 1 


M 


CH:'L' .BLKW 1 


M 


PROT 


'L' .BLKW 1 
.IF NDF 

.BLKW 2 


M 


NXT: 


L' .BLKW 1 

.ENDC 


M 


RVOL 


'L' .BLKB 1 


M 


STAT 


'L' .BLKB 1 


M 


VIDP 


'L' .BLKW 1 


M.UCB: 


L' .BLKW 1 


S 


MVL= 


B'. 

.PSECT 




UNMOUNTED VOLUME AND 






.ASECT 


^3 


=0 




L 


NXT: 


L' .BLKW 1 


L 


VOLl 


•L' .BLKB 1 


L.V0L2 


•L' .BLKB 1 


L 


VIDl 


'L' .BLKB 6 


L 


VID2 


'L' .BLKB 6 


S.UVL= 


B'. 






.PSECT 



R$$11M 



R$$11M 



;PTR TO NXT MVL NODE (IIM) 

; OWNER UIC FROM RVOL #1 

; U.CH/U.VP (IID) 

; PROTECTION U.AR IN IID 

; ACP WORDS IID 

;PTR TO NEXT MVL NODE (IID) 

; RELATIVE VOL # OF MOUNTED VOLUME 
; VOLUME STATUS 
; VOLUME ID POINTER 
;ADDR OF ASSOC UCB OR PUD 
;SIZE OF MVL NODE 



PTR TO NXT UVL NODE 
REL VOL # OF I'ST VOL IN NODE 
REL VOL # OF 2'ND VOL IN NODE 
VOL ID OF I'ST VOL IN NODE 
VOL ID OF 2'ND VOL IN NODE 
SIZE OF UVL NODE 



SYSTEM DATA STRUCTURE CONTENT VALUES 



; VSCB VALUES 




; V.MOU VALUES 




VM.OLD ='B' 


200 


VM.BYP ='B' 


100 


VM.ULB ='B' 


40 


VM.FSC ='B' 


20 


VM.EXC ='B' 


10 



OLD .FL300 VOLUME ~ VM.BYP WILL ALSO BE SET 

BYPASS LABEL PROCESSING 

UNLABELED TAPE 

OVERRIDE FILE SET ID CHECK 

OVERRIDE EXPRIATION DATE CHECK 
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; V.MS'H VALUES 




V2 


INI 


= 'B' 


1 


V2 


XH2 


= 'B' 


2 


V2 


XH3 


= "B' 


4 


V2 


NH3 


= 'B' 


10 


V2 


OAC 


= <B' 


20 


; V.PSTA, VALUES 


- UNBL 


VP 


RM 


= 'B' 


2 


VP 


WM 


= 'B' 


4 


VP 


UCM 


= 'B' 


6 


VP 


SM 


= 'B' 


10 


VP 


MOU 


= >B' 


20 


VP 


RWD 


= 'B' 


40 


VP 


VFY 


= 'B' 


VP.RWD 


VP 


POS 


= 'B' 


100 



MAG WANTS US TO INITIALIZE NEXT OUTPUT 
THIS FILE HAS NO HDR2. DON'T WRITE E0F2 
THIS FILE HAS NO HDR3, DON'T WRITE E0F3 
DON'T WRITE HDR3/E0X3 LABELS 
OVERRIDE FILE/VOLUME ACCESIBILITY 



UNBLOCKED TRANSITION STATE 



READ DATA MODE 

WRITE DATA MODE 

UNLABELLED CREATE POSITIONING MODE 

SEARCH MODE 

MOUNT MODE 

REWIND OR VOL VERIFICATION WAIT 

; PROCESS IN POSITIONING MODE (MULTI-SECTION FILE) 



BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES) 

PROCESS TIMED OUT BIT = 1 
VP.TO='B'l 



NULL WINDOW CONTROL BIT DEFINITIONS 



WI.RDV 


= 'B' 


400 


ACCESSED FOR READ 


WI.WRV 


= 'B' 


1000 


ACCESSED FOR WRITE 


WI.EXT 


= 'B' 


2000 


ACCESSED FOR EXTEND 


WI.LCK 


= 'B' 


4000 


LOCKED 



MVL VALUES IN THE M.STAT FIELD 



MS.VER 


s'B' 


200 


MS. RID 


= 'B' 


1 


MS.NMO 


= 'B' 


2 


MS.TMO 


= 'B' 


4 


MS. EXP 


= 'B' 


10 



VOL ID NOT VERIFIED 
VOL ID TO BE READ NOT CHECKED 
MOUNT MESSAGE NOT GIVEN YET 
ONE TIMEOUT ALREADY EXPRIED 
EXPIRATION DATE MESSAGE GIVEN 



MISC BITS USED IN MOUNT (STORED IN V.STS) 



.OVR 


= 'B' 


1 ; 


.UIC 


= 'B' 


2 ; 


.PRO 


= 'B' 


4 : 


.160 


= 'B' 


10 ; 



OVER RIDE VOL NAME SWITCH 
EXPLICIT UIC GIVEN 
EXPLICIT PROTECTION GIVEN 
1600 BPI SPECIFIED 



.ENDM 
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.MACRO OLRDF$ $$$GBL 

.MCALL .WORD.,DEFIN$ 

-IF IDN <$$$GBL> , <DEF$G> 
. .GBL=1 

.IFF 
. .GBL=0 

.ENDC 

THE FOLLOWING MACRO DEFINES THE SUB-FUNCTION CODES FOR EACH OF THE OPERATIONS 

PERFORMED BY THE HRC TASK AND A PARAMETER DESCRIBING THE ARGUMENTS REQUIRED 

FOR EACH FUNCTION. 

IN A MACRO CALL THE FOLLOWING ARE THE LEGAL COMBINATIONS FOR THE 'MASK' 

PARAMETER: 

<> SIGNIFYING NO PARAMETERS 

<D> SIGNIFYING ONE BUFFER DESCRIPTOR 

<D,D> SIGNIFYING TWO BUFFER DESCRIPTORS 

<D,CT> SIGNFIYING ONE DESCRIPTOR AND 'CT' BYTES OF PARAMETERS 

<CT> SIGNIFYING 'CT' BYTES OF PARAMETERS 

.MACRO FUNC NAME.SUBF, FUN, MASK 
.WORD. 10. 'NAME.SUBF, FUN 
FUNCA NAME,<MASK> 
.ENDM 

.MACRO FUNCA NAME.MSK 

PARCT=0 

DESCT=0 

.IRP X,<MSK> 

.IIF IDN <X>,<P> PARCT=PARCT+1 

.IIF IDN <X>.<D> DESCT=DESCT+1 

.IIF GT <PARCT-17> .ERROR INVALID PARAMETER COUNT 

.IIF GT <DESCT-17> .ERROR INVALID DESCRIPTOR COUNT 

.ENDR 

TEMP=<DESCT*4>+<PARCT*2> 

. WORD . 10$ ' NAME , «DESCT*20+PARCT» . TEMP 

.ENDM 

DEFINE ONLINE RECONFIGURATION I/O FUNCTIONS 



.WORD. 10. MFC. 000. 001 
.WORD. IO.RSC.000.002 
.WORD. IO.WSC.000.006 



MULTI-FUNCTION MODIFY CONFIGURATION 
READ SYSTEM CONFIGURATION 
MODIFY DEVICE CONFIGURATION 



DEFINE SUBFUNCTIONS TO MODIFY DEVICE CONFIGURATION 
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FUNC ONL,001.006.<D,D> 

FUNC OFL,002,006.<D,D> 

FUNC MAI.003.006.<D,D> 

FUNC CAC, 004, 006,0 

FUNC MEM, 005,006.0 

FUNC STN,006,006,<P.P> 

FUNC HRC,007,006,<P,P> 

FUNC DNE.010,006,<P,P> 

FUNC STA,011,006,<D> 

FUNC IF .012.006,<P,P> 

FUNC RLI,0i3.006,<D,D,D,D> 

FUNC RUL,014,006,<D,D.D,D> 

FUNC MBO,015,006,<P,P.D,D.D.D 

FUNC RSW,016.006.<D,D.D,D> 

FUNC WAT, 017, 006, <D> 

FUNC RAT,020,006.<D,D> 

FUNC MBF,021.006.<P,P,D,D,D,D 

I0$MAX=21 



SET DEVICE ONLINE 

SET DEVICE OFFLINE 

SET DEVICE IN MAINTAINENCE MODE 

CACHE CONTROL 

MIND CONTROL 

RECONFIGURATION CONTROL, 

SPECIFY TASK NAME 

RECONFIGURATION CONTROL, 

HRC OPERATING MODE 

ON <CONDITION> <COMMAND> 

RETURN DEVICE STATE 

IF <CONDITION> <COMMAND> 

LINK UNIBUS RUN 

UNLINK UNIBUS RUN 
D,D,D.D> ; MEMORY BOX ONLINE 

SWITCH BUS 

WRITE ATTRIBUTES 

READ ATTRIBUTES 
D,D,D,D> ; MEMORY BOX OFFLINE 

DEFINE MAXIMUM SUBFUNCTION 



DEFIN$ IS.HRG,6. 



STOP PROCESSING CONDITION ENCOUNTERED 
SECOND STATUS WORD IS ARGUMENT 



DEFINE A MACRO, WHICH WHEN EXPANDED WITH THE APPROPRIATE DEFINITION 
FOR .lOER. WILL DEFINE THE PRIVATE ERROR CODES USED BY HRC AND CON. 



; DEFINE INITIAL ERROR NUMBER VALUE 



.MACRO 


OLREM$ 


$$$VAL° 


-2B6. 


.lOER. 


IE$OAL 


.lOER. 


IE$DNL 


.lOER. 


IE$PRM 


.lOER. 


IE$SYN 


.lOER. 


IE$AFE 


.lOER. 


IE$TMU 


.lOER. 


IE$CAB 


.lOER. 


IE$TRP 


.lOER. 


IE$ALG 


.lOER. 


IE$TQU 


.lOER. 


IE$EPO 


.lOER. 


IE$EUO 


.lOER. 


IE$ECO 


.lOER. 


IE$EPF 


.lOER. 


IE$EUF 


•lOER. 


lElECF 


.lOER. 


IE$CFU 


.lOER. 


IE$CSR 


.lOER. 


IE$SWF 


.lOER. 


IE$ICE 


.lOER. 


IE$SCE 


.lOER. 


IE$MDE 


.lOER. 


IE$NFW 


.lOER. 


IE$CXT 


.lOER. 


IE$IDU 


,IOER. 


IE$UNK 



,<DEVICE already linked> 

,<DEVICE not liiiked> 

, <Parameter error> 

,<Syntax error> 

,<Attribute format error> 

,<HRC... Internal tables insufficient for this S7Stem> 

,<Unable to access busrun> 

, <HRC . . . internal addressing error> 

,<Meinory box parameter error> 

,<Tineout on iinit quieting operation> 

.<ONLINE CPU failure> 

,<ONLINE UNIT failure> 

.<ONLINE CONTROLLER fallure> 

,<OFFLINE CPU failure> 

,<OFFLINE UNIT failure> 

.<OFFLINE CONTROLLER failure> 

,<Attempt to quiet unit for controller failed> 

,<CSR for controller not present in I/O page> 

,<Unable to switch unit away from current controller> 

,<HRC... detected I/O database consistancy error> 

,<Executive or Driver status change error> 

, <HRC . . , Memory descriptor format error> 

,<No path to target device is available> 

,<Unable to take unit with context offline. > 

,<Invalid device de8criptor> 

,<Device is un]mown in this configuration> 
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.lOER. IE$SZE,<HRC. . . Unable to access device to size drive> 

.lOER. IE$POB . <HRC . . . Can't take box offline. Partition overmaps box> 

.lOER. IE$NLB . <HRC . . . Can't take box offline. Not last box in memory> 

.lOER. IE$OMP , <HRC . . . Can't modify partition size. Overmap exists> 

.lOER. IE$POC , <HRC . . . Can't modify partition size. Occupied> 

.lOER. IE$DFE,<HRC. . . Request format error. > 

.lOER. IE$IDS , <HRC . . . Invalid device specification. > 

.lOER. IE$UOE,<HRC. . . Unkown error from online/offline call> 

.ENDM 

CONDITION CODES FOR CONDITIONS TESTED BY 10. ONE AND 10. IF FUNCTIONS 



CO$ONL = 1 
CO$OFL = 2 
CO$UNK = 3 
CO$ACC = 4 
CO$MY - 6 
CO$MAI = 6 

CO$MAX = 6 



IF DEVICE NOW ONLINE 

IF DEVICE NOW OFFLINE 

UNKNOWN DEVICE 

ACCESSABLE (ACCESS PATH EXISTS) 

ANY ERROR CONDITION 

MAINTENANCE MODE 

MAXIMUM CODE 



CONDITION COMMAND CODES FOR 10. ONE AND 10. IF FUNCTIONS 



CD$STO = 2 
CD$GOT = 4 
CD$CON = 6 

CD$MAX = 6 



; 'STOP' COMMAND 

; 'GOTO' 

; 'CONTINUE' 

; MAXIMUM CONDITION DEFINED 



ARGUMENT DEFINITION FOR lO.HRC FUNCTION 



M$LOG = 1 
M$INIT = 2 
M$DEBG = 4 
M$EXIT = 10 



SUPRESS CONFIGURATION TRANSMISSION TO ERRLOG 
INITALIZE HRC 

SET HRC INTO DEBUG MODE. (DEVELOPMENT ONLY) 
EXIT REQUEST (FROM ABORT AST REQUEST) 



DEFINE TABLE OFFSETS AND STATUS BITS RETURNED IN RESPONSE TO 
A 'READ CONFIGURATION' QIO 



.ASECT 
.=0 
C$DTYP: .BLKB 1 



ENTRY TYPE FIELD 



ENTRY TYPE CODES ARE AS FOLLOWS 



ET$HDR - 1 
ET$END = 2 

ET$DEV = 'A 



; CONFIGURATION HEADER ENTRY 
; END OF CONFIGURATION DATA 

; MINIMUM VALUE FOR DEVICE SPECIFICATION ENTRY 



System Data Structures and Symbolic Definitions C-51 



OLRDF$ 



C$DECT 


.BLKB 


1 


C$DVER 


.BLKB 


1 


C$DSTD 


.BLKB 


1 


CIDMUB 


.BLKB 


1 


C$DMCT 


.BLKB 
.EVEN 


1 


C$DFAC 


.BLKW 


2 


C$DIDN 


.BLKW 


9 


C$STD: 







COUNT OF TABLE ENTRIES (CPUS+SWITCHED 

BUS RUNS+CONTROLLERS+UNITS) 

VERSION OF RECONFIGURATION TASK PROTOCAL 

SIZE OF HEADER 

MAXIMUM UNIBUS RUNS SUPPORTED 

MAXIMUM CONTROLLERS OF A GIVEN TYPE SUPPORTED 

FACILITES SUPPORTED IN HOST SYSTEM 
HRC VERSION AND BUILD TIMESTAMP 
SIZE OF THE TABLE HEADER 



OFFSETS WITHIN THE FIXED PORTION OF A GIVEN ENTRY 
.=0 



CIDTYP 






CIDNAM 


.BLKW 




C$DPUN 


.BLKB 




C$DLUN 


.BLKB 




CtDSCT 


.BLKB 




C$DEVT 


.BLKB 




C$DSTS 


.BLKW 





FUG VALUES FOR C$DSTS 

CS$ATR-1 
CS$EXF=76 

CS$SUB=100 

;CS$XXX=200 

CS$0FL-400 

CS$PDF=1000 

CS$POR=2000 

CS$MBD»4000 

CS$UNK==10000 

CS$ACC=20000 

CS$MTD=40000 

CSSDRV^'IOOOOO 

C$DST2: .BLKW 1 

CS$PUN=20 

CS$CRO°40 

CS$PRC=100 

CS$CTL»200 

CS$Da^3400 



DEVICE CLASS VALUES 



ENTRY TYPE CODE 

TWO ASCII CHARACTER UNIT OR CONTROLLER NAME 

CONTROLLER NUMBER (0-255.) 

LOGICAL UNIT NUMBER IF THIS DEVICE IS A UNIT 

SUB-CONTROLLER NUMBER 

DEVICE TYPE CODE 

DEVICE STATUS MASK 



VARIABLE LENGTH ATTRIBUTE INFO IS APPENDED 

FIELD IN C$DSTS CONTAINING COUNT OF ADDITIONAL 

BYTES IN THIS DEVICE ENTRY 

THIS IS A SUB-CONTROLLER DEVICE 

UNUSED 

1=>DEVICE IS OFFLINE, 0=>DEVICE IS ONLINE 

DEVICE IS RESTRICTED TO PRIVILEGED DIAG FNS 

THIS IS A MULTIPORT DEVICE 

DEVICE IS A MASS BUS DEVICE 

DEVICE IS UNKNOWN 

AN ONLINE ACCESS PATH EXISTS TO THIS DEVICE 

DEVICE IS MOUNTED (DISK) OR LOGGED IN (TERM) 

A DRIVER IS LOADED FOR THIS DEVICE 

STATUS EXTENSION 

1=> THIS DEVICE SPECIFIED WITH PHYSICAL UNIT NUMBER 
1=> THIS IS A CONTROLLER RELATIVE DEVICE SPEC 
1=> THIS IS A PORT RELATIVE CONTROLLER SPEC 
DEVICE IS A CONTROLLER (MUST BE SIGN BIT) 
DEVICE CLASS CODE FIELD. MUST BE LOW ORDER BITS 
OF HIGH BYTE. 
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DC$UMI = 
DC$CTL = 1 
DC$MKU - 2 
DC$MKC = 3 
DC$SBU = 4 
DC$SBC =: 5 
DC$CPU - 6 
:DC$XXX s 7 

CIDDAT: .BLKW 2 
C)SM£: 



UNIT 

CONTROLLER 

MEMORY BOX UNIT 

MEMORY BOX CONTROLLER 

SWITCHED BUS UNIT 

SWITCHED BUS CONTROLLER 

CPU 

UNUSED 

DEVICE DEPENDANT DATA 
SIZE IF A MINIMUM ENTRY 



VARIABLE PORTION OF A GIVEN ENTRY 



FOR CONTROLLERS 

.=C$SME 
C$DKPO: .BLKW 1 



CISCT: 



FOR UNIT ENTRIES 

.=C|SME 
C$DCTH: .BLKW 1 

C^DUPO: .BLKW 1 

CtSUN: 

FOR CPU-S 

.»C$SME 
C$DCPO: .BLKW 1 

CISCP: 

FOR MEMORY BOXES 

. -C$SME 

CIDCTN: .BLKW 1 
.BLKW 4 

CISMB: 



PORT-STATOS-WORD. THIS DESCRIBES THE BUS RUN 
CPU OR SWITCHED BUS, TO WHICH THIS 
CONTROLLER IS CONNECTED. 
MINIMUM SIZE OF A CONTROLLER ENTRY 



CONTROLLER NAME. TWO CHARACTER ASCII CODE 

OF THE CONTROLLER TO WHICH THIS UNIT IS 

ATTACHED. 

PORT-STATUS-WORD. THIS IS THE 

FIRST OF THE PSWS DESCRIBING THE CONTROLLER (S) 

TO WHICH THIS UNIT IS CONNECTED. 

MIMIMUM SIZE OF A UNIT ENTRY 



PORT-STATUS-WORD. THIS IS THE BUS 
NUMBEH FOR THIS CPU. 
MINIMUM SIZE OF A CPU ENTRY 



: CONTROLLER NAME. 

; MAXIMUM OF 4 PORTS FOR MEMORY CONTROLLERS 

; MAXIMUM SIZE OF A MEMORY BOX ENTRY 



STATUS BIT DEFINITIONS FOR THE PORT STATUS WORD 



System Data Structures and Symbolic Definitions C-53 



OLRDF$ 



CP$OFL=400 

CP$XXX=1000 

CP$CUR=2000 

CP$XXX=4000 
CP$XXX=10000 
CP$ACC=20000 
CP$MTD=40000 

CP$XXX=100000 



1=> PORT IS OFFLINE 

UNUSED 

THIS PORT IS THE CURRENT PORT (S.KRB 

REFERENCES THIS PORT 

UNUSED 

UNUSED 

THIS PORT HAS AN ACCESS PATH 

PORT HAS CONTEXT OR SERVICES A DEVICE HAVING 

CONTEXT 

UNUSED 



DEVICE ATTRIBUTES CODES 

.MACRO ATT NAME.SIZ 

$$$TMP=$$$TMP+1 

DEFIN$ DA$'NAME.$$$TMP!<400*SIZ> 

• ENDM 



$$$TMP=0 




ATT 


CSR.2 


CSR ADDRESS 


ATT 


VEC.2 


VECTOR ADDRESS 


ATT 


UBR.2 


UNIBUS RUN 


ATT 


TYP.2 


DEVICE TYPE, READ ONLY 


ATT 


VOL.12. 


MOUNTED VOLUME NAME. READ ONLY 


ATT 


ERR, 10 


DEVICE ERROR COUNTERS, READ/WRITE 


ATT 


PRI.2 


DEVICE INTERRUPT PRIORITY 


ATT 


MBP,6 


MEMORY BOX PARAMETER 


ATT 


STE,2 


SANITY TIMER ENABLE/DISABLE 


ATT 


SAL, 2 


ALARM ENABLE/DISABLE 


ATT 


DSN,2 


DEVICE SERIAL NUMBER 


ATT 


CSN,10 


CPU SERIAL NUMBERS 



MEMORY BOX ATTRIBUTE BUFFER 



C$MBAS : 
C$MINT: 

C$MSIZ: 
C$MGRN: 

C$MDSC : 



.ASECT 
.=0 

.BLKW 
.BLKB 
.BLKB 
.BLKW 
.BLKW 



BASE ADDRESS OF BOX 

INTERLEAVE FACTOR 

FREE BYTE 

SIZE OF BOX IN 32 WORD BLOCKS 

BOX GRANULARITY. "BYTES-PER-UNIT" 

SIZE OF BOX ATTRIBUTE BUFFER 



.PSECT 



REDEFINE MACRO TO NULL 



.MACRO OLRDF$ X 

.ENDM 

.MACRO ATT X 

.ENDM 
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.ENDM 



MACRO FOR THE DEFINITION OF DEVICE TYPE CODES 



.GBL=1 



.MACRO DEVCD$ $$$GBL 

.MCALL DEFIN$ 

.IF IDN <$$$GBL>,<DEF$G> 
L 
.IFF 



.GBL=0 



.EHDC 



.MACRO DEV X 




DEFIN$ D$'X,$$$TMP 


$$$TMP=$$$TMP+1 




.ENDM 




$$$TMP = 




DEV UDET 


UNDETERMINED DEVICE TYPE 


DEV UKNO 


UNKNOWN DEVICE TYPE 


DEV RK03 


RK03 


DEV RK08 


RK05 


DEV RK5F 


RK05-F (DUAL DENSITY FIX 


DEV RXOl 


RXOl 


DEV RX02 


RX02 (DUAL DENSITY RXOl) 


DEV RLOl 


RLOl 


DEV RL02 


RL02 


DEV RP02 


RP02 


DEV RP03 


RP03 


DEV RP04 


RP04 


DEV RP05 


RP05 


DEV RP06 


RP06 


DEV RP07 


RP07 


DEV RK06 


RK06 


DEV RK07 


RK07 


DEV RM02 


RM02 


DEV RM03 


RM03 


DEV RM05 


RM05 


DEV RM80 


RM80 


DEV RS03 


RS03 


DEV RS04 


RS04 (DUAL DENSITY RS03) 


DEV RFll 


RF11/RS08 
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DEV TK25 


TK25 


DEV TK50 


TK50 


DEV TUlO 


TUlO 


DEV TU16 


TU16 


DEV TU45 


TU45 


DEV TU77 


TU77 


DEV TU78 


TU78 


DEV TSll 


TSll 


DEV TSUO 


TSU05 


DEV TSVO 


TSV05 


DEV TU80 


TU80 


DEV TU81 


TU81 


DEV TM02 


TM02 


DEV TM03 


TM03 


DEV TM78 


TM78 


DEV TU56 


TU56 


DEV TU58 


TU58 


DEV TU60 


TU60 


DEV MSCP 


UDA50 


DEV RA60 


RA60 


DEV RA80 


RA80 


DEV RA81 


RA81 


DEV RC25 


RC25 (AZTEC) 


DEV RD60 


RD50 


DEV RD51 


RD51 


DEV RX50 


RX50 


DEV MLll 


MLll 


DEV TERM 


TERMINAL 


$$$TMP=370 




DEV USRO 


USER TYPE 


DEV USRl 


USER TYPE 1 


DEV USR2 


USER TYPE 2 


DEV USR3 


USER TYPE 3 


DEV USR4 


USER TYPE 4 


DEV USR5 


USER TYPE 5 


DEV USR6 


USER TYPE 6 


DEV USR7 


USER TYPE 7 


.MACRO DEVCD$ 




.ENDM 




.MACRO DEV X 




.ENDM 





.ENDM 
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.MACRO PCBDF$ L.B.SYSDEF 



MAIN PARTITION PCB 



.ASECT 



.=0 






P.LNK: 


L'.BLKW 


1 




.BLKW 


1 


P.NAM: 


L'.BLKW 


2 


P. SUB: 


L'.BLKW 


1 


P. MAIN 


'L' .BLKW 


1 


P.REL: 


L'.BLKW 


1 


P.BLKS 


'L' 




P. SIZE 


•L' .BLKW 


1 


P. WAIT 


■L' .BLKW 


2 




.BLKW 


2 


P.STAT 


'L' .BLKW 


1 


P.ST2: 


L' .BLKW 


1 




.BLKW 


3 


P.HDLN 


'L'.BLKB 


1 


P. IOC: 


L' .BLKB 


1 


$$$=. 






P.RRM: 


L'.BLKW 


1 




.IF NDF M$$PRO 



LINK TO NEXT MAIN PARTITION PCB 

(UNUSED) 

PARTITION NAME IN RAD50 

POINTER TO FIRST SUBPARTITION 

POINTER TO SELF 

STARTING PHYSICAL ADDRESS IN 32W BLOCKS 

SIZE OF PARTITION IN 32W BLOCKS 

PARTITION WAIT QUEUE LISTHEAD 

(UNUSED) 

PARTITION STATUS FLAGS 

STATUS EXTENSION FOR COMMON AND MAIN PCB'S 

(UNUSED) 

SIZE OF EXTERNAL HEADER IN 32W BLOCKS 
PARTITION I/O COUNT 



: REQUIRED RUN MASK 



.=$$$ 



.ENDC 



.IF NB SYSDEF 
P.LGTH='B'. 

.ENDC 



: PARTITION CONTROL BLOCK LENGTH 



TASK REGION PCB 
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.=0 




P.LNK:'L'.BLKW 




P.PRIi'L'.BLKB 




P.RMCT:'L'.BLKB 




P.NAM; 'L'.BLKW 




P.SUBi'L'.BLKW 




P. MAIN: 'L'.BLKW 




P. REL: 'L'.BLKW 




P.BLKS:'L' 




P. SIZE: 'L'.BLKW 




.BLKW 




P. SWSZ: 'L'.BLKW 




P. DPCB: 'L'.BLKW 




P. TCB: 'L'.BLKW 




P. STAT: 'L'.BLKW 




P.HDR:'L' .BLKW 




.BLKW 




P.ATT:'L' .BLKW 




P.HDLN:'L'.BLKB 




P.IOC:'L' .BLKB 




$$$=. 




P. RRM: 'L'.BLKW 


1 


.IF NDF M$$PRO 



.=$$$ 



.ENDC 



UTILITY LINK WORD 

PRIORITY OF PARTITION 

RESIDENT MAPPED TASKS COUNT 

PARTITION NAME IN RAD50 

POINTER TO NEXT SUBPARTITION 

POINTER TO MAIN PARTITION 

STARTING PHYSICAL ADDRESS IN 32W BLOCKS 

SIZE OF PARTITION IN 32W BLOCKS 

(UNUSED) 

PARTITION SWAP SIZE 

CHECKPOINT ALLOCATION PCB 

TCB ADDRESS OF OWNER TASK 

PARTITION STATUS FLAGS 

POINTER TO HEADER CONTROL BLOCK 

(UNUSED) 

ATTACHMENT DESCRIPTOR LISTHEAD 

SIZE OF EXTERNAL HEADER IN 32W BLOCKS 
PARTITION I/O COUNT 



; REQUIRED RUN MASK 



COMMON REGION PCB 



.=0 

P.LNK: 'L' 
P.PRI:'L' 
P.RMCT:'L 
P.NAM: 'L' 
P. SUB: 'L' 
P.MAIN:'L 
P.REL:'L' 
P.BLKS:'L 
P. SIZE: 'L 
P.CBDL:'L 
P.CSBA:'L 



BLKW 

BLKB 

.BLKB 

BLKW 

BLKW 

.BLKW 

BLKW 

.BLKW 
.BLKW 



SWSZ: 'L'.BLKW 
,DPCB:'L' .BLKW 
,OWN:'L' .BLKW 
STAT: 'L'.BLKW 



ST2 
PRO 

ATT 



'L' .BLKW 
'L' .BLKW 
'L' .BLKW 



P.HDLN:'L'.BLKB 1 
P.IOC:'L' .BLKB 1 

$$$=. 



UTILITY LINK WORD 

PRIORITY OF PARTITION 

RESIDENT MAPPED TASKS COUNT 

PARTITION NAME IN RAD50 

POINTER TO NEXT SUBPARTITION 

POINTER TO MAIN PARTITION 

STARTING PHYSICAL ADDRESS IN 32W BLOCKS 

SIZE OF PARTITION IN 32W BLOCKS 

COMMON BLOCK DIRECTORY LINK 

CACHE STATISTICS BLOCK LISTHEAD 

...(IF P2.CHE IS SET, PARTITION WON'T SWAP) 

PARTITION SWAP SIZE 

POINTER TO DISK PCB 

OWNING UIC OF REGION 

PARTITION STATUS FLAGS 

STATUS EXTENSION FOR COMMON AND MAIN PCB'S 

PROTECTION WORD [DEWR , DEWR . DEWR , DEWR] 

ATTACHMENT DESCRIPTOR LISTHEAD 

SIZE OF EXTERNAL HEADER IN 32W BLOCKS 
PARTITION I/O COUNT 
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P.RRM:'L'.BLKW 1 

.IF NDF M$$PRO 

.ENDC 

.PSECT 

I- 
PARTITION STATUS WORD BIT DEFINITIONS 



; REQUIRED RUN MASK 



' 100000 

'40000 

'20000 

' 10000 

'4000 

'2000 

'1000 

'400 

'200 

'100 

•40 

•20 

'10 

•4 

•2 



REQUIRED RUN MASK 



PS.OUT= 


B' 


PS.CKP= 


B' 


PS.CKR= 


B' 


PS.CHK= 


B' 


PS.FXD= 


B' 


PS.CAF= 


B' 


PS.LIO= 


B' 


PS.NSF= 


B' 


PS.COM= 


B' 


PS.LFR= 


B' 


PS.PER= 


B' 


PS.NWB= 


B' 


PS.DEL= 


B' 


PS.AST= 


B' 


PS.CSA= 


B' 



PR.UBT= 
PR.UBS= 
PR.UBR= 
PR.UBP= 
PR.UBN= 
PR.UBM= 
PR.UBL= 
PR.UBK= 
PR.UBJ= 
PR.UBH= 
PR.UBF= 
PR.UBE= 
PR.CPD= 
PR.CPC= 
PR.CPB= 
PR.CPA= 



' 100000 

'40000 

' 20000 

' 10000 

'4000 

'2000 

'1000 

"400 

'200 

' 100 

'40 

■20 

'10 

'4 

'2 

•1 



PARTITION IS OUT OF MEMORY (1=YES) 

PARTITION CHECKPOINT IN PROGRESS (1=YES) 

PARTITION CHECKPOINT IS REQUESTED (1=YES) 

PARTITION IS NOT CHECKPOINTABLE (1=YES) 

PARTITION IS FIXED (1=YES) 

CHECKPOINT SPACE ALLOCATION FAILURE (1=YES) 

MARKED BY SHUFFLER FOR LONG I/O (1=YES) 

PARTITION IS NOT SHUFFLEABLE (1=YES) 

LIBRARY OR COMMON BLOCK (I'YES) 

LAST LOAD OF REGION FAILED (1=YES) 

PARTIY ERROR OCCURED IN THIS REGION (1=YES) 

COMMON SHOULDN'T BE VWIITTEN BACK 

PARTITION SHOULD BE DELETED WHEN NOT ATTACHED (1=YES) 

PARTITION HAS REGION LOAD AST PENDING 

CHECKPOINT SPACE ALLOCATED 



UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN 



UNIBUS RUN M 



L 
K 
J 



UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN H 
UNIBUS RUN F 
UNIBUS RUN E 
PROCESSOR D 
PROCESSOR C 
PROCESSOR 6 
PROCESSOR A 



STATUS EXTENSION WORD BIT DEFINITIONS 

(THESE BITS CAN ONLY BE EXAMINED IN COMMON OR MAIN FOB'S) 
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P2.LMA='B'40000 



P2 


.CPC= 


B 


20000 


P2 


.CHE= 


B 


10000 


P2 


.SEC= 


B 


4000 


P2 


.PAR= 


B 


2000 


P2 


.POL= 


B 


1000 


P2 


.CPU= 


B 


400 


P2 


.PIC= 


B 


200 


P2 


.RON= 


B 


100 


P2 


.DRV= 


B 


40 


P2 


.LDD= 


B 


20 


P2 


.APR= 


B 


7 


; + 

; 


CHECKI 


»0] 


[NT FILE 






.ASECT 


.= 









P. 


LNK: 'I 


1 


.BLKW 1 


P. 


UCB:'! 


1 


.BLKW 1 


P. 


LBN:'I 


1 

-* 


.BLKW 1 






.BLKW 1 


P. 


SUB: 'I 


1 


.BLKW 1 


P. MAIN: 


L 


.BLKW 1 


P. 


aEL:'I 


1 


.BLKW 1 


P. 


SIZE: 


L 


.BLKW 1 


P.DLGH= 


B 





DON'T SHUFFLE. DELETE SPINDLE OR MUTILATE 

THIS PARTITION 

CPCR INITIATED CHECKPOINT PENDING 

CACHE PARTITION 

THIS IS RO SECTION OF MU TASK 

WITH TCB IN SEC. POOL 

THE FIXER TASK HAS HANDLED A PARITY ERROR 

SECONDARY POOL PARTITION 

MULTIPROCESSOR CPU PARTITION 

POSITION INDEPENDENT LIBRARY OR COMMON (1=YES) 

READ-ONLY COMMON (1=YES) 

DRIVER COMMON PARTITION (1=YES) 

LOAD DEVICE DISABLED/DISMOUNTED 

STARTING APR NUMBER MASK FOR NON-PIC COMMON 



LINK WORD OF CHECKPOINT FILE PCB'S 

UCB ADDRESS OF CHECKPOINT FILE DEVICE 

HIGH PART OF STARTING LBN 

LOW PART OF STARTING LBN 

POINTER TO FIRST CHECKPOINT ALLOCATION PCB 

MUST BE (FOR $RLPR1) 

CONTAINS IF FILE IN USE. 1 IF NOT IN USE 

SIZE OF CHECKPOINT FILE IN 256W BLOCKS 

LENGTH OF ALL DISK PCB'S 



CHECKPOINT ALLOCATION PCB 



.BLKW 4 
P.SUB:'L' .BLKW 1 
P. MAIN: 'L' .BLKW 1 
P.REL:'L' .BLKW 1 
P. SIZE: 'L' .BLKW 1 



(UNUSED) 

LINK TO NEXT CHECKPOINT ALLOCATION PCB 

ADDRESS OF CHECKPOINT FILE PCB 

RELATIVE POSITION IN FILE IN 256W BLOCKS 

SIZE ALLOCATED IN 256W BLOCKS 



COMMON TASK IMAGE FILE PCB 

.=0 

P.FID1:*L' .BLKW 1 
P.UCB:'L' .BLKW 1 
P.LBN:'L' .BLKW 1 

.BLKW 1 
P.IID='B' P.LBN+2 
P.FID2:'L' .BLKW 1 
P. MAIN: 'L'. BLKW 1 
P.REL:'L' .BLKW 1 
P. FIDS: 'L' .BLKW 1 



FILE ID WORD FOR SAVE 

UCB ADDRESS OF DEVICE ON WHICH COMMON RESIDES 

HIGH PART OF STARTING LBN 

LOW PART OF STARTING LBN 

IMAGE INDEX FOR CPR SYSTEMS 

FILE ID WORD FOR SAVE 

POINTER TO SELF 

ALWAYS CONTAINS A 

FILE ID WORD FOR SAVE 
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ATTACHMENT DESCRIPTOR OFFSETS 



NOTE: THE DETACH REGION ROUTINE DEPENDS ON THE FACT THAT: 

A.TCB IS AT OFFSET 4 FROM A.PCBL 
A.PCB IS AT OFFSET 4 FROM A.TCBL 

REFER TO $DETRG IN MODULE PLSUB FOR MORE DETAILS 



.ASECT 
.=0 

A.PCBL: 'L" .BLKW 1 
A.PRI:'L'.BLKB 1 
A.IOC:'L'.BLKB 1 
A.TCB:'L'.BLKW i 
A.TCBL:'L'.BLKW 1 
A.STAT:'L'.BLKB 1 
A.MPCT:'L'.BLKB 1 
A.PCB:'L'.BLKW 1 
A.LGTH='B'. 



PCB ATTACHMENT QUEUE THREAD WORD 

PRIORITY OF ATTACHED TASK 

I/O COUNT THROUGH THIS DESCRIPTOR 

TCB ADDRESS OF ATTACHED TASK 

TCB ATTACHMENT QUEUE THREAD WORD 

STATUS BYTE 

MAPPING COUNT OF TASK THRU THIS DESCRIPTOR 

PCB ADDRESS OF ATTACHED TASK 

LENGTH OF ATTACHMENT DESCRIPTOR 



ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS 



.PSECT 
AS.PR0='B'10O 
AS.SBP='B'20 
AS.RBP='B'40 
AS.DEL='B'10 
AS.EXT='B'4 
AS.WRT='B'2 
AS.RED='B'l 

.MACRO 

.ENDM 

.ENDM 



A.TCB IS SEC POOL TCB BIAS (1=YES) 
CACHE BYPASS REQUESTED 
REQUEST TO NOT BYPASS CACHE 
TASK HAS DELETE ACCESS (1=YES) 
TASK HAS EXTEND ACCESS (1=YES) 
TASK HAS WRITE ACCESS (1=YES) 
TASK HAS READ ACCESS (1=YES) 



PCBDF$ X.Y.Z 
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.MACRO PKTDF$.L,B,SYSDEF 



ASYNCmONOUS SYSTEM TRAP CONTROL BLOCK OFFSET DEFINITIONS 

SOME POSITIONAL DEPENDENCIES BETWEEN THE OCB AND THE AST CONTROL BLOCK 
ARE RELIED UPON IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 



.ASECT 
.=177774 

A.KSR6:<L< .BLKW 1 
A.DQSR:'L' .BLKW 1 

.BLKW 1 
A.CBL:'L' .BLKW 1 



A.BYT:'L' .BLKW 

A.AST:'L' .BLKW 

A.NPR:'L' .BLKW 

A.PRM:'L* .BLKW 



AS.FPA= 

AS. RCA 

AS.RRA= 

AS. PEA 

AS.REA 

AS.PFA 

AS.CAA° 



•B'l 
>B'2 
'B'3 
<B'4 
'B'5 
'B'6 
•B'7 



BIT VALUES IN A.PRM+5 



AF.XCG='B'l 

AF.N0T='B'2 

AF.00B-<B'4 

AF.AST='B'10 

AF.ESq='B'20 

AF.LCK='B'40 

AF.QUE='B'100 

AF.MDE>'B'200 



SUBROUTINE KISAR5 BIAS (A.CBL=0) 

DEQUEUE SUBROUTINE ADDRESS (A.CBL=0) 

AST QUEUE THREAD WORD 

LENGTH OF CONTROL BLOCK IN BYTES 

IF A.CBL = 0, THE AST CONTROL BLOCK IS 

TO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE 

POINTED TO BY A.DQSR MAPPED VIA APR 5 

VALUE A.KSR5. THIS IS CURRENTLY USED ONLY 

BY THE FULL DUPLEX TERMINAL DRIVER FOR 

UNSOLICITED CHARACTER ASTS. 

IF THE LOW BYTE OF A.CBL = 0, AND THE 

HIGH BYTE IS NOT = 0, THE AST CONTROL BLOCK 

IS A SPECIFIED AST, WITH LENGTH. C.LGTH. 

IF THE HIGH BYTE OF A.CBL=0 

AND THE LOW BYTE > 0, THEN 

THE LOW BYTE IS THE LENGTH OF THE 

AST CONTROL BLOCK. 

IF HIGH BYTE = AND LOW BYTE IS NEGATIVE, 

THEN THE BLOCK IS A KERNEL AST 

BIT 6 IS SET IF $SGFIN SHOULD 

NOT BE CALLED PRIOR TO DISPATCHING 

THE AST, AND THE LOW SIX BITS (5-0) 

REPRESENT THE INDEX/2 INTO THE 

KERNEL AST DISPATCH TABLE ($KATBL) 

NUMBER OF BYTES TO ALLOCATE ON TASK STACK 

AST TRAP ADDRESS 

NUMBER OF AST PARAMETERS 

FIRST AST PARAMETER 

CODE FOR FLOATING POINT AST 

CODE FOR RECEIVE DATA AST 

CODE FOR RECEIVE BY REFERENCE AST 

CODE FOR PARITY ERROR AST 

CODE FOR REQUESTED EXIT AST 

CODE FOR POWER FAIL AST 

CODE FOR CLI COMMAND ARRIVAL AST 



ATTACHED FOR ALL BUT CONTROL-C (TF.XCC) 

ATTACHED FOR ALL NOTIFICATION (TF.NOT) 

ACB IS FOR OUT-OF-BAND AST 

ACB HANDLES UNSOL. INPUT CHAR AST'S (TF.AST) 

ATTACHED FOR ESCAPE SEQUENCES (TF.ESQ) 

ACB IS LOCKED 

ACB IS QUEUED 

ACB IS MARKED FOR DELETE 
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ABORTER SUBCODES FOR ABORT AST (AS.REA) TO BE RETURNED ON USER'S STACK 



AB.NPV= 
AB.TYP= 



AB.CTC='B'4 
A.PLGH='B'70 
A.DUCB='B'10 
A.DLGH='B'10. 



ABDRTER IS NONPRIVILEGED (1=YES) 

ABORT FROM DIRECTIVE (0=YES) 

ABORT FROM CLI COMMAND (1=YES) 

ABORT FROM CONTROL-C GIN PROCESSING (1=YES) 

SIZE OF PARITY ERROR AST CONTROL BLOCK 

UCB OF TERM ISSUING DEBUG COMMAND 

LENGTH OF DEBUG (AK.TBT) AST BLOCK 



KERNEL AST CONTROL CODES (A.CBL) 



AK.BUF='B'200 



AK.0CB='B'2Ol 
AK.GBI=<B<202 
AK.TBT='B'203 
AK.DI0='B'2O4 
AK.GGF='B'205 
+ 



BUFFERED I/O COMPLETION 

THIS CODE MUST BE 200 UNTIL ALL 

REFERENCES IN TTDRV ARE FIXED 

OFFSPRING TASK EXIT 

SEGMENTED BUFFERED I/O COMPLETION 

TASK FORCE T-BIT TRAP (DEBUG CMD) 

DELAYED I/O COMPLETION 

GRP. GBL. RUNDWN 



BIT DEFINITIONS FOR THE GET/SET INFORMATION DIRECTIVE. 



SF.PRV='B' 100000 
SF.IN='B' 40000 



; FUNCTION IS PRIVILEGED 

; FUNCTION IS AN INPUT FUNCTION 



GROUP GLOBAL EVENT FLAG BLOCK OFFSETS 



.=0 

G.LNK:'L'.BLKW 1 
G.GRP:'L'.BLKB 1 
G.STAT:'L'.BLKB 1 
G.CNT:'L'.BLKW 1 



G.EFLGi'L' 
G.L6TH='B'. 

GS.DEL='B'l 



BLKW 2 



LINK WORD 

GROUP NUMBER 

STATUS BYTE 

ACCESS COUNT 

EVENT FLAGS 

LENGTH OF GROUP GLOBAL EVENT FLAG 

BLOCK 

STATUS BIT ~ MARKED FOR DELETE 



EXECUTIVE POOL MONITOR CONTROL FLAGS 



$POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL MONITOR 



PC.HIH='B'l 
PC.L0W='B'2 
PC.ALF='B'4 
PC.XIT='B'200 



PC.NRM= 
PC.ALM= 



■B'PC.HIH*400 
'B'PC.LOW*400 



HIGH POOL LIMIT CROSSED (1=YES) 
LOW POOL LIMIT CROSSED (1=YES) 
POOL ALLOCATION FAILURE (1=YES) 
FORCE POOL MONITOR TASK TO EXIT (MUST 
BE COUPLED WITH SETTING FE.MXT IN THE 
FEATURE MASK) 

POOL TASK INHIBIT BIT FOR HIGH POOL 
POOL TASK INHIBIT BIT FOR LOW POOL 



$POLFL IS THE POOL USAGE CONTROL WORD 



PF.INS='B'40 

PF.L0G='B'100 

PF.REQ='B'200 



REJECT NONPRIVILEGED INS/RUN/REM 
NONPRIVILEGED LOGINS ARE DISABLED 
STALL REQUEST OF NONPRIV. TASKS 
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PF.ALL='B' 177777 



;TAKE ALL POSSIBLE ACTIONS TO SAVE POOL 



• OFFSPRING CONTROL BLOCK DEFINITIONS 

; SOME POSITIONAL DEPENDENCIES ARE DEPENDED ON BETWEEN THE OCB AND THE 
; AST BLOCK IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 



.=0 

O.LNK:'L'.BLKW 1 
O.MCRL:'L'.BLKW 1 
O.PTCB:'L' .BLKW 1 
O.AST:'L' .BLKW 1 
O.EFN:'L'.BLKW 1 
O.ESB: 'L' .BLKW 1 



O.STAT: 
O.LGTH= 



.BLKW 8. 



OCB LINK WORD 

ADDRESS OF MCR COMMAND LINE 

PARENT TCB ADDRESS 

EXIT AST ADDRESS 

EXIT EVENT FLAG 

EXIT STATUS BLOCK VIRTUAL ADDRESS 

EXIT STATUS BUFFER 

LENGTH OF OCB 



I/O PACKET OFFSET DEFINITIONS 

NOTE: THE ROUTINE $QRMVT IN MODULE QUEUE DEPENDS ON THE FACT THAT 
I. TCB IS AT OFFSET 4 IN AN I/O PACKET. 



.=0 

I.LNK:' 

I.PRI:' 

I.EFN:' 

I. TCB:' 

I.LN2:' 

I.UCB:' 

I.FCN:' 

I.IOSB 



LAST: 
I.PRM: 



.ASECT 

.BLKW 
.BLKB 
.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
L' .BLKW 

BLKW 

BLKW 
.BLKW 
.BLKW 

BLKW 

BLKW 



I/O QUEUE THREAD WORD 

REQUEST PRIORITY 

EVENT FLAG NUMBER 

TCB ADDRESS OF REQUESTOR 

POINTER TO SECOND LUN WORD 

POINTER TO UNIT CONTROL BLOCK 

I/O FUNCTION CODE 

; VIRTUAL ADDRESS OF I/O STATUS BLOCK 
I/O STATUS BLOCK RELOCATON BIAS 
I/O STATUS BLOCK ADDRESS 
AST SERVICE ROUTINE ADDRESS 
RESERVED FOR MAPPING PARAMETER #1 
PARAMETERS 1 TO 6 ^ 
USER MODE DIAGNOSTIC PARAMETER WORD 



FOLLOWING ARE DEFINITIONS FOR FLAG BITS IN I.PRM+11 
(DSA DRIVERS INTERNAL USE ONLY) 



IP.FAK ='B' 20 
IP. ABO ='B' 40 
IP.PND ='B' 100 
IP.UMR ='B'200 

I.ATTL='B'. 



I.AADA:'L' .BLKW 2 

I.LGTH='B'. 

I.ATRL='B'6*8. 



lOP IS PSEUDO lOP 

(MUDRV) ABORT COMMAND MUST BE ISSUED FOR lOP 
(MUDRV) ABORT COMMAND WAS ISSUED FOR lOP 
A UMR WAIT BLOCK IS IN USE FOR THIS I/O 

MINIMUM LENGTH OF I/O PACKET (USED BY 
FILE SYSTEM TO CALCULATE MAXIMUM 
NUMBER OF ATTRIBUTES) 
STORAGE FOR ATT DESCR PTRS WITH I/O 
LENGTH OF I/O REQUEST CONTROL BLOCK 
LENGTH OF FILE SYSTEM ATTRIBUTE BLOCK 
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DEFINE OFFSETS IN I/O PACKET EXTENSION (lOPX) 



.ASECT 



I.XLNK: 
I.XIOP: 
I.XTCB: 
I.XMOD: 

I.XRBF: 

I.XRBL: 
I.XTMO: 
I.XPBF: 

I.XPBL: 
I.XPBV: 
I.XTTB: 

I.XTTL: 
I.XDBF: 

I.XDBL: 



L' .BLKW 1 

L' .BLKW 1 

L' .BLKW 1 

L' .BLKW 2 

L' .BLKW 2 

L' .BLKW 1 

L' .BLKW 1 

L' .BLKW 2 

L' .BLKW 1 

L' .BLKW 1 

L' .BLKW 2 

L' .BLKW 1 

L' .BLKW 2 

L' -BLKW 1 



LINK WORD 

I/O PACKET ADDRESS 

TCB ADDRESS OF REQUESTING TASK 

MODIFIER WORDS (NOTE: 2ND WORD MUST BE 

SPECIFIED AND MUST BE ZERO.) 

READ DATA BUFFER ADDRESS APR BIAS 

READ DATA BUFFER VIRTUAL ADDRESS 

READ DATA BUFFER LENGTH 

READ TIME-OUT INTERVAL 

PROMPT BUFFER ADDRESS APR BIAS 

PROMPT BUFFER VIRTUAL ADDRESS 

PROMPT BUFFER LENGTH 

PROMPT BUFFER VERTICAL FORMS CONTROL 

TERMINATOR TABLE ADDRESS APR BIAS 

TERMINATOR TABLE VIRTUAL ADDRESS 

TERMINATOR TABLE LENGTH 

DEFAULT INPUT BUFFER ADDRESS APR BIAS 

DEFAULT INPUT BUFFER VIRTUAL ADDRESS 

DEFAULT INPUT BUFFER LENGTH 



I.XLEN='B'. 
+ 
CLI PARSER BLOCK (CPB) DEFINITIONS 



LENGTH OF lOPX 



C.PTCB:'L' 
C.PNAM:'L' 
C.PSTS: 'L' 
C.PDPL: 'L' 
C.PCPL:'L' 
C.PRMT:'L' 



.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 



STATUS BIT DEFINITIONS 

CP.NUL='B'l 

CP.MSG='B'2 

CP.LG0='B'4 

CP.DSB='B'10 

CP.PRV='B'20 

CP.SGL='B'40 

CP.NIO='B'100 

CP.RST='B'200 

CP.EXT='B'400 

CP.P0L='B'1000 

CP.CTC='B'2000 



ADDRESS OF CLI'S TCB 

CLI NAME 

STATUS MASK 

LENGTH OF DEFAULT PROMPT 

LENGTH CNTRL/C PROMPT 

START OF PROMPT STRINGS. DEFAULT 

IS CONCATENATED WITH CONTROL C PROMPT 



PASS EMPTY COMMANDS TO CLI 

CLI DESIRES SYSTEM MESSAGES 

CLI WANTS COMMANDS FROM LOGGED OFF TTYS 

CLI IS DISABLED 

USER MUST BE PRIV TO SET TTY TO THIS CLI 

DON'T HANDLE CONTINUATIONS (M-PLUS ONLY) 

MCR. . . . HEL. BYE DO NO I/O TO TTY 

HEL, BYE DO NOT SET CLI ETC. 

ABILITY TO SET TO THIS CLI IS RESTRICTED 

TO THE ai ITSELF 

PASS TASK EXIT PROMPT REQUESTS TO CLI 

CLI TCB IS IN SECONDARY POOL 

"C NOTIFICATION PACKETS ARE WANTED 



SECONDARY POOL COMMAND BUFFER BLOCKS 
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C.CLK:'L' 

C.CTCB:'L' 

C.CUCB:'L' 

C.CCT:'L' 

COSTS: 'L' 

C.CMCD:'L' 

C.CSO:"L' 

C.CTR:'L' 

C.CBLK:'L' 

C.CTXT:'L' 



.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 

.BLKW 
.BLKB 
.BLKB 



LINK WORD 

TCB ADDRESS OF TASK TO RECEIVE COMMAND 

UCB ADDRESS OF RESPONSIBLE TERMINAL 

CHARACTER COUNT, EXCLUDING TRAILING CR 

STATUS MASK 

SYSTEM MESSAGE CODE 

STARTING OFFSET OF VALID COMMAND TEXT 

TERMINATOR CHARACTER 

SIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS 

COMMAND TEXT. FOLLOWED BY CR 



STATUS BITS FOR COMMAND BLOCKS 



CC.MCR= 
CC.PRM= 
CC.EXT= 
CC.KIL= 
CC.CLI= 
CC.MSG= 
CC.TTD= 
CC.CTC= 



'B'l 

'B'2 

'B'4 

"B'lO 

'B'20 

'B'40 

•B'lOO 

'B'200 



FORCE COMMAND TO MCR 

ISSUE DEFAULT PROMPT 

TASK EXIT PROMPT REQUEST 

DELETE ALL CONTINUATION PIECES FROM THIS TTY 

COMMAND TO BE RETREIVED BY GCCI$ ONLY 

PACKET CONTAINS SYSTEM MESSAGE TO CLI 

COMMAND CAME FROM TTDRV 

-C NOTIFICATION PACKET 



IDENTIFIER CODES FOR SYSTEM TO CLI MESSAGES 

CODES 0-127. ARE RESERVED FOR USE BY DIGITAL 
CODES 128.-255. ARE RESERVED FOR USE BY CUSTOMERS 



CLI INITIALIZED ENABLED 

CLI INITIALIZED DISABLED 

CLI ENABLED 

CLI DISABLED 

CLI BEING ELIMINATED 

CLI MUST EXIT IMMEDIATELY 

NEW TERMINAL LINKED TO CLI 

TERMINAL REMOVED FROM CLI 

GENERAL MESSAGE TO CLI 



CM.INE= 


B'l 


CM.IND= 


B'2 


CM.CEN= 


B'3 


CM.CDS= 


B'4 


CM.ELM= 


B'5 


CM.EXT= 


B'6 


CM.LKT= 


B'7 


CM.RMT= 


B'B 


CM.MSG= 


B'9 



ANCILLARY CONTROL BLOCK (ACB) DEFINITIONS 
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.=0 

A.REL:'L' .BLKW 1 
A.DIS:"L' .BLKW 1 
A.MAS: 'L' .BLKW 2 
A.NUM:'L' .BLKB 1 
A.FLEN:'L'.BLKB 1 
A.LIN: 'L' .BLKW 1 
A.ACC:'L' .BLKB 1 
A.STA:'L' .BLKB 1 
A.PLEN='B' . 



ACD RELOCATION BIAS 

ACD DISPATCH TABLE POINTER 

ACD FUNCTION MASK WORDS 

ACD IDENTIFICATION NUMBER 

LENGTH IN BYTES OF FULL ACB 

ACD LINK WORD 

ACD ACCESS COUNT 

ACD STATUS BYTE 

LENGTH IN BYTES OF PROTOTYPE ACB 



.=A.LIN 

A.IMAP:'L' 

A.IBUF:'L' 

A.ILEN:'L' 

A.SMAP:'L' 

A.SBUF:'L' 

A.SLEN:'L' 

A.IOS:'L' 

A.RES='B'. 



.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 2 



FULL ACB OVERLAPS PROTOTYPE ACB 

ACD INTERRUPT BUFFER RELOCATION BIAS 

ACD INTERRUPT BUFFER ADDRESS 

ACD INTERRUPT BUFFER LENGTH 

ACD SYSTEM STATE BUFFER RELOCATION BIAS 

ACD SYSTEM STATE BUFFER ADDRESS 

ACD SYSTEM STATE BUFFER LENGTH 

ACD I/O STATUS 

START OF ACB RESERVED FOR USE BY THE ACD 



DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG 



UA.ACC= 
UA.PRO= 
UA.ECH= 
UA.TYP= 
UA.SPE= 
UA.PUT= 
UA.CAL= 
UA.COM= 

UA.ALL= 
UA.TRN= 
UA.TRA= 



B'l 

B'2 

B'4 

B'lO 

B'20 

B'40 

B'iOO 

B'2O0 

B'400 

B'lOOO 

B'2000 



ACCEPT THIS CHARACTER 

PROCESS THIS CHARACTER 

ECHO THIS CHARACTER 

FORCE THIS CHARACTER INTO TYPEAHEAD 

THIS CHARACTER HAS A SPECIAL ECHO 

PUT THIS CHARACTER IN THE INPUT BUFFER 

CALL THE ACD BACK AFTER THE TRANSFER 

COMPLETE THE INPUT REQUEST 

ALLOW PROCESSING OF THIS I/O REQUEST 
TRANSLATE CHARACTERS FROM OUTPUT QIO 
TRANSFER CHARACTERS WHEN I/O COMPLETES 



DEFINE THE ACD ENTRY POINTS (OFFSETS INTO THE DISPATCH TABLE) 



.=0 

A.ACCE: 

A.DEQU: 

A.POWE: 

A.INPU: 

A.OUTP: 

A. CONN: 

A. DISC: 

A.RECE: 

A.PROC: 

A.TRAN: 

A, CALL: 



'L' 
'L' 
'L' 
'L' 
'L* 
'L' 
'L' 
■L' 
'L' 
'L' 
'L' 



.BLKW 1 



.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 



I/O REQUEST ACCEPTANCE ENTRY POINT 

I/O REQUEST DEQUEUE ENTRY POINT 

POWER FAILURE ENTRY POINT 

INPUT COMPLETION ENTRY POINT 

OUTPUT COMPLETION ENTRY POINT 

CONNECTION ENTRY POINT 

DISCONNECTION ENTRY POINT 

INPUT CHARACTER RECEPTION ENTRY POINT 

INPUT CHARACTER PROCESSING ENTRY POINT 

OUTPUT QIO CHARACTER TRANSLATION ENTRY POINT 

CALL ACD BACK AFTER TRANSFER ENTRY POINT 
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DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB 

AS.DLT='B'l ;ACD IS MARKED FOR DELETE 

AS.DIS='B'2 ;ACD IS DISABLED 

.PSECT 

-MACRO PKTDF$ X,Y,Z 

.ENDM 

.ENDM 
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.MACRO SCBDF$.L.B.SYSDEF 



STATUS CONTROL BLOCK 

THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE CONTROLLER. 
THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM. THE SCB IS POINTED TO 
BY UNIT CONTROL BLOCKS. TO EXPAND ON THE TELETYPE EXAMPLE ABOVE. EACH TELE- 
TYPE INTERFACED VIA A DLll-A WOULD HAVE A SCB SINCE EACH DLll-A IS AN IN- 
DEPENDENT INTERFACE UNIT. THE TELETYPES INTERFACED VIA THE DHll WOULD ALSO 
EACH HAVE AN SCB SINCE THE DHll IS A SINGLE CONTROLLER BUT MULTIPLEXES MANY 
UNITS IN PARALLEL. 





.IF NB 


SYSDEF 




.ASECT 




.=0 






S.LHD: 


•L' .BLKW 


2 


S.URM: 


•L' 






.IF DF 


M$$PRO 




.BLKW 


1 




.ENDC 




S.FRK: 


•L' .BLKW 


1 




.BLKW 


1 




.BLKW 


1 




.BLKW 


1 




.IF DF 


L$$DRV 


S.KS5: 


'L' .BLKW 
.ENDC 


1 


S.PKT: 


'L' .BLKW 


1 


S.CTM: 


■L- .BLKB 


1 


S.ITM; 


'L' .BLKB 


1 


S.STS: 


•L' .BLKB 


1 


S.ST3: 


•L'.BLKB 


1 


S.ST2: 


'L' .BLKW 


1 


S.KRB: 


'L' .BLKW 


1 


S.RCNT 


: 'L'.BLKB 


1 


S.ROFF 


: 'L'.BLKB 


1 


S.EMB: 


■L'.BLKW 


1 


S.KTB: 


'L' .BLKW 


1 



; CONTROLLER I/O QUEUE LISTHEAD 
: REFERENCE LABEL 



;UNIBUS RUN MASK FOR THE FORK BLOCK 



FORK BLOCK LINK WORD 

FORK -PC 

F0RK-R5 

F0RK-R4 



:FORK KISAR5 



ADDRESS OF CURRENT I/O PACKET 

CURRENT TIMEOUT COUNT 

INITIAL TIMEOUT COUNT 

STATUS (0=FREE, NE 0=BUSY) 

STATUS EXTENSION BYTE 

STATUS EXTENSION 

ADDRESS OF KRB 

NUMBER OF REGISTERS TO COPY 

OFFSET TO FIRST DEV REG TO COPY 

ERROR MESSAGE BLOCK POINTER 

START OF MULTI-ACCESS KRBS 



.PSECT 



OFFSETS FOR MSCP/TMSCP DRIVER DATA BASES (MUDRV. DUDRV) 



S.P0RT='B'S.EMB+2 
S.PBIA='B'S.EMB+4 
S.QST='B'S.EMB+6 
S.BSYU='B'S.EMB+10 

.IFF 



FIRST 3 CHAR. OF PORT NAME IN RAD50 

BIAS OF PORT 

ADDRESS OF QST (MU.DU CONTR. TABLE) 

UNIT ASSOCIATED WITH OLDEST CMD TO CONTR. 
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STATUS CONTROL BLOCK STATUS EXTENSION BIT DEFINITIONS 



S2.EIP='B'l 

S2.ENB=<B<2 

S2.L0G=<B<4 

S2.MAD='B'10 

S2.LDS==<B<40 

S2.0PT='B'100 

S2.C0N='B'200 

S2.0P1='B'400 

S2.0P2='B'1000 



S2.ACT='B'2000 
S2.XHR='B<4000 
S2.KRQ='B' 10000 



ERROR IN PROGRESS (1=YES) 

ERROR LOGGING ENABLED (0=YES) 

ERROR LOGGING SUPPORTED (1=YES) 

MULTIACCESS DEVICE (1=YES) 

LOAD SHARING ENABLED (1=YES) 

SUPPORTS SEEK OPTIMIZATION (1=YES) 

SCB AND KRB ARE CONTIGUOUS (1=YES) 

THESE TWO BITS DEFINE THE OPTIMIZATION 

METHOD. 

0P2,0Pl-0,0 INDICATES NEAREST CYLINDER 

0P2.0P1=0,1 INDICATES ELEVATOR 

0P2,0P1=1,0 INDICATES C-SCAN 

0P2,0P1=1,1 RESERVED 

DRIVER HAS OPERATION OUTSTANDING (1=YES) 

EXTERNAL HEADER AND NEW I.LN2 SUPPORT 

SCB IS QUEUED IN CONTROLLER REQUEST QUEUE 



STATUS CONTROL BLOCK STATUS EXTENSION (S.ST3) DEFINITIONS 



S3 


DRL= 


B 


1 




S3 


NRL= 


B 


2 




S3 


SIP= 


B 


4 




S3 


ATN= 


B 


10 




S3 


SLV= 


B 


20 




S3 


SPA= 


B 


40 




S3 


SPB= 


B 


100 




S3 


OPT= 


B 


200 




S3 


SPU= 


B 


S3. SPA! S3 


SP6 



MULTI-ACCESS DRIVE IN RELEASED STATE (1=YES) 

DRIVER SHOULDN'T RLS MULTI-ACCESS DRIVE (1=YES) 

SEEK IN PROGRESS (1-YES) 

DRIVER MUST CLEAR ATTENTION BIT (1=YES) 

DEVICE USES SLAVE UNITS (1=YES) 

PORT -A' SPINNING UP 

PORT 'B' SPINNING UP 

SEEK OPTIMIZATION ENABLED (1=YES) 

.OR. OF PORT SPINUP BITS 



KRB ADDRESS TABLE (S.KTB) PORT OFFLINE FROM THIS SCB FLAG. 



KP.OFL='B'l 



;KRB ADDRESS POINTS TO OFFLINE PORT (1=YES) 
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MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT) 



.ASECT 
.=0 

M.LNK:'L' 
M.UMRA:'L' 
M.UMRN:'L' 
M.UMVL:'L' 
M.UMVH:'L' 
M.BFVH:'L' 
M.BFVL:'L' 
M.LGTH='B' 



.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 



BLKW 1 



LINK WORD 

ADDRESS OF FIRST ASSIGNED UMR 

NUMBER OF UMR'S ASSIGNED * 4 

LOW 16 BITS MAPPED BY 1ST ASSIGNED UMR 

HIGH 2 BITS MAPPED IN BITS 4 AND 5 

HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS 

LOW 16 BITS OF PHYSICAL BUFFER ADDRESS 

LENGTH OF MAPPING ASSIGNMENT BLOCK 



.ENDC 



.PSECT 

.MACRO 

.ENDM 

.ENDM 



SCBDF$.X,Y,Z 
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.MACRO SHDDF$,L.B,SYSDEF 



FIRST. WE MUST DEFINE THE I/O PACKET DEFINITIONS, SINCE Vffi 
USE THEM IN OUR DEFINITIONS. 



PKTDFI 



; DEFINE I/O PACKET DEFINITIONS 



SHADOW RECORDING LINKAGE BLOCK (UMB) 

THE UMB LINKS TOGETHER TWO UCB'S AS A SHADOW SET. ONE IS THE 
PRIMARY UCB. THE OTHER THE SECONDARY UCB. THE EXISTANCE OF A 
UMB SIGNALS THAT SHADOW RECORDING IS ENABLED ON A PARTICULAR 
UCB. 



.ASECT 

.=0 

M.LNK:'L' .BLKW 

M.LHD:'L' .BLKW 

M.UCBS:'L'.BLKW 

M.STS:'L 

M.LBN:'L 



.BLKW 
.BLKB 
.BLKB 
.BLKW 



LINKAGE OF ALL UMB' S IN THE SYSTEM 

LISTHEAD OF ALL ML NODES FOR THIS SET 

PRIMARY AND SECONDARY UCB ADDRESSES 

STATUS WORD 

HIGH ORDER BYTE OF FENCE 

UNUSED BYTE (MAYBE STATUS?) 

LOW ORDER WORD OF FENCE 



M.LGH=. 



UMB STATUS BIT DEFINITIONS 



.PSECT 



MS.MDA'B'=1 
MS.CHP*B'=2 



;UMB MARKED FOR DEALLOCATION (1=YES) 
; CATCHUP IN PROGRESS (1=YES) 



DEFINE THE OFFSETS FOR THE ML NODE. LINKED OFF OF THE UMB 
THROUGH CELL M.LHD. THIS NODE CONTAINS THE SECONDARY I/O 
PACKET. AND DOUBLES AS THE ERROR PACKET TO THE ERROR MESSAGE 
TASK. 

.ASECT 



ML.LNK: 


•L' 


.BLKW 1 


ML.LEN: 


•L' 


.BLKB 1 


ML.TYP: 


'L' 


.BLKB 1 


ML.DNC: 


'L' 


.BLKB 1 
.BLKB 1 


ML.PRI: 


'L' 


.BLKW 1 


ML.PKT: 


•L' 


.BLKB I.LGTH 


ML.LGH^ 







LINKAGE OF ALL ML NODES ON UMB 

LENGTH OF ML NODE FOR DEALLOCATION 

TYPE OF ML NODE FOR ERROR TASK 

DONE COUNT OF PACKETS 

UNUSED 

PRIMARY I/O PACKET ADDRESS 

SECONDARY I/O PACKET 



ML NODE TYPE CODES 



.PSECT 
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MT.PKT'B'=1 

+ 



;ML NODE IS I/O PACKET TYPE 
I/O PACKET OFFSET DEFNS FOR USE BY SHADOW RECORDING 



I.RO'B'=I.PRM 
I.Rl'B'=I.PRM+2 



; STATUS STORAGE FOR RO STATUS 
; STATUS STORAGE FOR Rl STATUS 



DEFINE THE ERROR MESSAGE POINTERS THAT RESIDE IN THE I/O PACKET. 



.PSECT 



ML.FID'B 

ML.FSEQ'B 

ML.LBN'B' 

ML.CNT'B' 

ML.TCB'B' 

ML.SRO'B' 

ML.SRl'B' 

ML.PRO'B' 

ML.PRl'B' 



=ML.PKT+I.IOSB 

•=ML.PKT+I.I0SB+2 

=ML.PKT+I.PRM+10 

=ML.PKT+I.PRM+4 

=ML.PKT+I.TCB 

=ML.PKT+I.RO 

=ML.PKT+I.R1 

=ML.PKT+I.PRM+14 

=ML.PKT+I.PRM+16 



FILE ID WHICH CONTAINS ERROR 

FILE SEQUENCE NUMBER OF FILE IN ERROR 

HIGH ORDER LBN OF BLOCK (S) IN ERROR 

NUMBER OF BLOCKS IN BAD XFER 

TCB OF TASK WITH BAD REQUEST 

RO OF SECONDARY I/O PACKET 

Rl OF SECONDARY I/O PACKET 

RO OF PRIMARY I/O PACKET 

Rl OF PRIMARY I/O PACKET 



.MACRO 

.ENDM 

.ENDM 



SHDDF$.X.Y.Z 
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.MACRO TCBDF$,L,B,SYSDEF 

h 

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS 
TASK CONTROL BLOCK 

.ASECT 



.=0 


T.LNK:'L' .BLKW 1 ; 


T.PRI:'L' .BLKB 1 ; 


T.IOC:'L' .BLKB 1 ; 


T.PCBV:'L' .BLKW 1 ; 


T.NAM: 'L' .BLKW 2 ; 


T.RCVL:'L' .BLKW 2 ; 


T.ASTL:'L' .BLKW 2 ; 


T.EFLG:'L' .BLKW 2 ; 


T.UCB;'L' .BLKW 1 ; 


T.TCBL:'L' .BLKW 1 ; 


T.STAT: 'L' .BLKW 1 ; 


T.ST2:'L' .BLKW 1 ; 


T.ST3;'L' .BLKW 1 ; 


T.DPRI:'L' .BLKB 1 ; 


T.LBN:'L' .BLKB 3 ; 


T.IID-'B' T.LBN+1 ; 


T.LDV:'L' .BLKW 1 : 


T.PCB:'L' .BLKW 1 ; 


T.MXSZ:<L< .BLKW 1 ; 


T.ACTL:'L' .BLKW 1 ; 


T.ATT:'L' .BLKW 2 ; 


T.ST4:'L' .BLKW 1 ; 


T.HDLN:'L' .BLKB 1 ; 


.BLKB 1 ; 


T.GGF:'L' .BLKB 1 ; 


T.TIO:'L' .BLKB 1 ; 


T.KKLM;'L' .BLKW 2 ; 


T.TKSZ:'L' .BLKW 1 ; 


$$$=. : 


T.OFF:'L' .BLKW 1 ; 


.BLKB 1 ; 


T.SRCT:'L' .BLKB 1 ; 


T.RRFL:'L' .BLKW 2 ; 


-IF NDF P$$LAS 



.»$$$ 



'TI' 



UTILITY LINK WORD 

TASK PRIORITY 

I/O PENDING COUNT 

POINTER TO COMMON PCB VECTOR 

TASK NAME IN RAD50 

RECEIVE QUEUE LISTHEAD 

AST QUEUE LISTHEAD 

TASK LOCAL EVENT FLAGS 1-32 

UCB ADDRESS FOR PSEUDO DEVICE 

TASK LIST THREAD WORD 

FIRST STATUS WORD (BLOCKING BITS) 

SECOND STATUS WORD (STATE BITS) 

THIRD STATUS WORD (ATTRIBUTE BITS) 

TASK'S DEFAULT PRIORITY 

LBN OF TASK LOAD IMAGE 

IMAGE INDEX FDR CPR SYSTEM 

UCB ADDRESS OF LOAD DEVICE 

PCB ADDRESS OF TASK PARTITION 

MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY) 

ADDRESS OF NEXT TASK IN ACTIVE LIST 

ATTACHMENT DESCRIPTOR LISTHEAD 

FOURTH TASK STATUS WORD 

LENGTH OF HEADER (0 IF HDR IN POOL) 

UNUSED 

GROUP GLOBAL USE COUNT FOR TASK 

BUFFERED I/O IN PROGRESS COUNT 

TASK WAITFOR MASK/ADDRESS 

TASK LOAD SIZE IN 32 WD BLOCKS 

MARK START OF PLAS AREA 

OFFSET TO TASK IMAGE IN PARTITION 

RESERVED 

SREF WITH EFN COUNT IN ALL RECEIVE QUEUES 

RECEIVE BY REFERENCE LISTHEAD 



:MOVE LC BACK TO START OF PLAS AREA 



.ENDC 



.IF NB SYSDEF 



$$$=. 

T.CTX:'L' .BLKW 1 

.IF NDF N$$DIR 
.=$$$ 



; POINTER TO CONTEXT BLOCK (DDS) 



C-74 System Datfi Structures and Symbolic Definitions 



TCBDF$ 



.ENDC : NDF N$$DIR 



$$9~ • 



T.OCBH:'L' .BLKW 2 
T.RDCT:'L' .BLKW 1 



;MARK START OF PARENT/OFFSPRING AREA 

; OFFSPRING CONTROL BLOCK LISTHEAD 
; OUTSTANDING OFFSPRING AND VT: COUNT 



.=$$$ 



.IF NDF P$$OFF 



.ENDC 



T.SASTi'L' .BLKW 1 
$$$" . 

T.RRM:'L'.BLKW 1 
T.IRM;'L'.BLKW 1 



T.CPU: 'L'.BLKB 1 
.BLKB 1 



E$$$ 



.IF NDF M$$PRO 



.ENDC 



T.ACN:'L'.BLKW 1 



.=$$$ 



.IF NDF A$$CNT 



.ENDC 



; SPECIFY AST LIST HEAD 



REQUIRED RUN MASK 

INITIAL RUN MASK SET UP BY INSTALL 

**** THIS WORD IS NO LONGER NECESSARY 

**** HOWEVER. INSTALL (INSLB) , MCR (SPAWN), 

**** AND VMR MUST BE MODIFIED 

PROCESSOR NUMBER ON WHICH TASK LAST EXECUTED 

(UNUSED) 



; POINTER TO ACCOUNTING BLOCK 



55$— . 
T.ISIZ:'L'.BLKW 1 

.IF NDF U$$DAS 
.=$$$ 

.ENDC ; NDF U$$DAS 

T.LGTH='B'. 
T.EXT='B'0 

. IFF 



:SIZE OF ROOT I SPACE 



; LENGTH OF TASK CONTROL BLOCK 
; LENGTH OF TCB EXTENSION 



TASK STATUS DEFINITIONS 

FIRST STATUS WORD (BLOCKING BITS) 
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TS.EXE= 
TS.RDN= 
TS.MSG= 
TS.CIP= 
TS.RUN= 
TS.RSW= 
TS . STP= 
TS.CKR= 
TS.BLC= 



'B' 100000 

"B'40000 

'B'20000 

'B' 10000 

■B'4000 

'B'2000 

'B'lOOO 

'B'lOO 

'B'37 



TASK NOT IN EXECUTION (1=YES) 

I/O RUN DOWN IN PROGRESS (1=YES) 

ABORT MESSAGE BEING OUTPUT (1=YES) 

TASK BLOCKED FOR CHECKPOINT IN PROGRESS (1=YES) 

TASK IS RUNNING ON ANOTHER PROCESSOR (1=YES) 

TASK IS WAITING FOR A REMOTE SERVICE 

TASK BLOCKED BY CLI COMMAND 

TASK HAS CKP REQUEST (MP SYSTEM ONLY) (1=YES) 

INCREMENT BLOCKING COUNT MASK 



KLN017 



TASK BLOCKING STATUS MASK 



TS.BLK='B' 177777 



SECOND STATUS WORD (STATE BITS) 



T2.AST= 


B' 


T2.DST= 


B' 


T2.CHK= 


B- 


T2.REX= 


B' 


T2.SEF= 


B' 


T2.SI0= 


B' 


T2.AFF= 


B' 


T2.HLT= 


B' 


T2.AB0= 


B' 


T2 . STP= 


B' 


T2.STP= 


B' 


T2.SPN= 


B' 


T2.SPN= 


B' 


T2.WFR= 


B' 


T2.WFR= 


B' 



' 100000 

' 40000 

■20000 

■ 10000 

■4000 

■1000 

■400 

■200 

■100 

'40 

■20 

'10 

■4 

■2 

■1 



AST IN PROGRESS (1=YES) 

AST RECOGNITION DISABLED (1=YES) 

TASK NOT CHECKPOINTABLE (1=YES) 

REQUESTED EXIT AST SPECIFIED 

TASK STOPPED FOR EVENT FLAG(S) (1=YES) 

TASK STOPPED FOR BUFFERED I/O 

TASK IS INSTALLED WITH AFFINITY 

TASK IS BEING HALTED (1=YES) 

TASK MARKED FOR ABORT (1=YES) 

SAVED T2.SPN ON AST IN PROGRESS 

TASK STOPPED (1=YES) 

SAVED T2.SPN ON AST IN PROGRESS 

TASK SUSPENDED (1=YES) 

SAVED T2.WFR ON AST IN PROGRESS 

TASK IN WAITFQR STATE (1=YES) 



THIRD STATUS WORD (ATTRIBUTE BITS) 



T3.ACP= 


B ' 100000 


T3.PMD= 


B^ 40000 


T3.REM= 


8^20000 


T3.PRV= 


B^ 10000 


T3.MCR= 


8^4000 


T3.SLV= 


8^2000 


T3.CLI= 


8^1000 


T3.RST= 


8^400 


T3.NSD= 


8^200 


T3.CAL= 


B'lOO 


T3.R0V= 


8^40 


T3.NET= 


8^20 


T3.MPC= 


B^IO 


T3.CMD= 


8^4 


T3.SWS= 


8'2 


T3.GFL= 


B'l 



ANCILLARY CONTROL PROCESSOR (1=YES) 

DUMP TASK ON SYNCHRONOUS ABORT (0=YES) 

REMOVE TASK ON EXIT (1=YES) 

TASK IS PRIVILEGED (1=YES) 

TASK REQUESTED AS EXTERNAL MCR FUNCTION (1=YES) 

TASK IS A SLAVE TASK (1=YES) 

TASK IS A COMMAND LINE INTERPRETER (1=YES) 

TASK IS RESTRICTED (1=YES) 

TASK DOES NOT ALLOW SEND DATA 

TASK HAS CHECKPOINT SPACE IN TASK IMAGE 

TASK HAS RESIDENT OVERLAYS 

NETWORK PROTOCOL LEVEL 

MAPPING CHANGE WITH OUTSTANDING I/O (1=YES) 

TASK IS EXECUTING A CLI COMMAND 

RESERVED FOR SOFTWARE SERVICES USE 

GROUP GLOBAL EVENT FLAG LOCK 



STATUS BIT DEFINITIONS FOR FOURTH STATUS WORD (T.ST4) 
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T4.LRW= 
T4.LBW= 
T4.DFB= 
T4.FMP= 
T4.CTC= 
T4.MUT= 
T4.LDD= 
T4.PR0= 
T4.PRV= 

T4.DSP= 
T4.SNC= 



B'2000 

B'lOOO 

B'400 

B'200 

B'lOO 

B'40 

B'20 

B'lO 

B'4 

B'2 
B'l 



TASK IS WAITING FOR A LOCAL RING 

TASK IS WAITING FOR A LOCAL BUFFER 

TASK HAS DEFERRED BINDING ENABLED 

TASK HAS FAST MAP HDR EXT. 

TASK HAS BEEN PROCESSED BY GIN "C ABORT 

TASK IS A MULTI-USER TASK 

TASK'S LOAD DEVICE HAS BEEN DISMOUNTED 

TCB IS (OR SHOULD BE) A PROTOTYPE 

TASK WAS PRIV. BUT HAS CLEARED T3.PRV 

WITH GIN (MAY RESET WITH GIN IF T4.PRV SET) 

TASK WAS BUILT FOR USER I/D SPACE 

TASK USES COMMONS FOR SYNCHRONIZATION 



KLN017 
KLN017 
KLFOIO 



REQUIRED RUN MASK 



TR.UBT= 
TR.UBS= 
TR.UBR= 
TR.UBP= 
TR.UBN= 
TR.UBM= 
TR.UBL= 
TR.UBK= 
TR.UBJ= 
TR.UBH= 
TR.UBF= 
TR.UBE= 
TR.CPD= 
TR.CPC= 
TR.CPB= 
TR.CPA= 



'B' 100000 

'B' 40000 

'B' 20000 

'B' 10000 

■B'4000 

'B'2000 

•B'lOOO 

'B'400 

'B'200 

'B'lOO 

'B'40 

'B'20 

•B'lO 

•B'4 

'B'2 

'B'l 

.ENDC 



UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN 
UNIBUS RUN N 
UNIBUS RUN M 
UNIBUS RUN L 
UNIBUS RUN K 
UNIBUS RUN J 
UNIBUS RUN H 
UNIBUS RUN F 
UNIBUS RUN E 
PROCESSOR D 
PROCESSOR C 
PROCESSOR B 
PROCESSOR A 



.PSECT 
.MACRO 

.ENDM 
.ENDM 



TCBDF$ X.Y.Z 
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.MACRO UCBDF$.L,B,TTDEF.SYSDEF 

+ 
UNIT CONTROL BLOCK 

THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL DEVICE 

UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE FIRST WORD OF 

AN ASSIGNED LUN. THERE IS ONE UCB FOR EACH DEVICE UNIT OF EACH DCB. THE 

UCB'S ASSOCIATED WITH A PARTICULAR DCB ARE CONTIGUOUS IN MEMORY AND ARE 

POINTED TO BY THE DCB. UCB'S ARE VARIABLE LENGTH BETWEEN DCB'S BUT ARE 

OF THE SAME LENGTH FOR A SPECIFIC DCB. TO FINISH THE TELETYPE EXAMPLE ABOVE, 

EACH UNIT ON BOTH INTERFACES WOULD HAVE A UCB. 

.ASECT 
=177772 

.IF NB SYSDEF 

.IF DF A$$CNT 

.ENDC ;DF A$$CNT 

.IF DF L$$GCL 



. = .-2 



. = .-2 








.ENDC 


;DF L$$GCL 


. = .-2 








.IF DF 


N$$DIR 


. = .-2 








.ENDC 


;DF N$$DIR 


U.UAB: 


•L' 






.IF DF 


A$$CNT 




.BLKW 


1 




.ENDC 


;DF A$$CNT 



; POINTER TO USER ACCOUNT BLOCK 



U.LOGi'L' 

.IF DF L$$GCL 

.BLKW 1 ; POINTER TO USER LOGICAL HASH TABLE 

.ENDC ;DF L$$GCL 

U.FPRO:'L' 

.BLKW 1 ; DEFAULT FILE PROTECTION WORD 

U.CTX: 'L' 

.IF DF N$$DIR 

.BLKW 1 ; POINTER TO TERMINAL CONTEXT BLOCK 

.ENDC ;DF N$$DIR 

.ENDC ;NB SYSDEF 
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U.MUP 


■L" .BLKW 1 


U.LUIC:'L' .BLKW 1 


U.OWN 


•L' .BLKW 1 


U.DCB 


•L' .BLKW 1 


U.RED 


'L' .BLKW 1 


U.CTL 


'L' .BLKB 1 


U.STS 


■L- .BLKB 1 


u.uNn 


r:'L' .BLKB 1 


U.ST2 


•L' .BLKB 1 


U.CWl 


'L' .BLKW 1 


U.CW2 


■L' .BLKW 1 


U.CW3 


■L' .BLKW 1 


U.CW4 


■L' .BLKW 1 


U.SCB 


•L' .BLKW 1 


U.ATT 


•L' .BLKW 1 


U.BUF 


•L' .BLKW 1 




.BLKW 1 


U.CNT 


•L' .BLKW 1 


U.UCB] 


l='B'U.CNT+2 


U.ACP= 


='B'U.CNT+4 


U.VCB= 


='B'U.CNT+6 


U.CBF= 


= 'B'U.Ca(T+2 


U.UMB' 


='B'U.CNT+10 


U.PRM= 


='B'U.CNT+12 


U . ICSI 


l='B'U.CNT+16 


U.SLT> 


='B'U.CNT+20 


U.SPM 


l='B'U.CNT+22 


U.UTII 


.='B'U.CNT+16 


• DEF] 


[NITIONS FOR I 


UU.SH 


I ='B'l 


UU.RCl 


r ='B'2 


UU.AVl 


J ='B'4 


UU.GUS 


3 ='B'10 


UU.ONl 


. ='B'20 


UU.SP( 


3 ='B'40 


UU.ATl 


I ='B'100 


UU.RD1 


f ='B'200 


UU.ABt 


) ='B'400 


UU.SIC 


3 ='B'1000 


UU.IOJ 


! ='B'2000 


UU.BLf 


[ =>B'4000 



U.BPKT='B'U.CNT+20 

U.MEDI-'B'U.BPKT 

U.UC2X='B'U.CNT+24 



MULTI-USER PROTECTION WORD 

LOGIN UIC - MULTI USER SYSTEMS ONLY 

OWNING TERMINAL - MULTI USER SYSTEMS ONLY 

BACK POINTER TO DCB 

POINTER TO REDIRECT UNIT UCB 

CONTROL PROCESSING FLAGS 

UNIT STATUS 

PHYSICAL UNIT NUMBER 

UNIT STATUS EXTENSION 

FIRST DEVICE CHARACTERISTICS WORD 

SECOND DEVICE CHARACTERISTICS WORD 

THIRD DEVICE CHARACTERISTICS WORD 

FOURTH DEVICE CHARACTERISTICS WORD 

POINTER TO SCB 

TCB ADDRESS OF ATTACHED TASK 

RELOCATION BIAS OF CURRENT I/O REQUEST 

BUFFER ADDRESS OF CURRENT I/O REQUEST 

BYTE COUNT OF CURRENT I/O REQUEST 

POINTER TO UCB EXTENSION IN SECONDARY POOL 

ADDRESS OF TCB OF MOUNTED ACP 

ADDRESS OF VOLUME CONTROL BLOCK 

CONTROL BUFFER RELOCATION AND ADDRESS 

ADDRESS OF UMB FOR SHADOW RECORDING 

DISK SIZE PARAMETER WORDS 

CSR ADDRESS (P/OS) 

SLOT ADRESS (P/OS) 

4 WD SAVED I/O PACKET AREA (R$$AMD) 

STATE WORD FOR UNIT 



SERIAL MODE 

(DUDRV)RCT IN PROGRESS 

UNIT IS WAITING FOR OTHER UNITS TO SPIN DOWN 

UNIT MUST HAVE A GUS COMMAND ISSUED 

UNIT MUST HAVE A ONL COMMAND ISSUED 

SPECIAL ONLINE TRANSITION 

UNIT HAS SENT ATTENTION MESSAGE 

UNIT IS READY 

IF SET. XXCAN SET UU.SER FLAG FOR UNIT 

THIS UNIT CAN STALL I/O 

THIS UNIT HAS I/O STALLED 

THIS UNIT DOESN'T ACCEPT DENSITY SETTINGS 

UNIT BAD BLOCK REPLACEMENT WAITING LIST 

MEDIA IDENTIFIER FOR MU TAPE 

POINTER TO SECOND EXTENSION IN SECONDARY POOL 



MAGTAPE DEVICE DEPENDANT UCB OFFSETS 



U.SNUM='B'U.CNT+10 
U.FCDE='B'U.CNT+12 
U.KRB1='B'U.CNT+14 



SUVE UNIT NUMBER 
FUNCTION CODE 
SUBCONTROLLER KRBl POINTER 
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DEFINE SECONDARY POOL UCB EXTENSION OFFSETS (ERROR LOGGING DEVICES ONLY) 



.=0 

X.NAME 
X.IOC: 
X.ERSL 
X.ERHL 
X.ERSC 
X.ERHC 
X.WCNT 



.6LKW 9. 
•L' .BLKW 2 
L' .BLKW 2 



.BLKB 
.BLK6 
.BLKB 
.BLKB 
.BLKW 



FIXED ACCOUNTING TRANSACTION HEADER 

DRIVE NAME IN RAD50 

I/O COUNT 

SOFT ERROR LIMIT 

HARD ERROR LIMIT 

SOFT ERROR COUNT 

HARD ERROR COUNT 

WORDS TRANSFERED COUNT 



DEFINE OFFSETS FOR SEEK OPTIMIZATION DEVICES 



X.CYLC: 
X.CCYL: 
X.FCUR: 
X.FLIM: 
X.DSKD: 

X.DNAM: 
X.UNIT: 
X.CSTS: 
X.CPCB: 
X.CSBA: 
X.CCED: 
X.XDAT: 
X.XRDA: 
X.XDIR: 
X.XL06: 
X.XOVR: 
X.CST2: 
X.LGTH= 
X.DFFL= 
X.DFSL= 
X.DFHL= 



.BLKW 2 

.BLKW 1 

.BLKB 1 

.BLKB 1 

.BLKW 1 

.BLKB 1 



.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 
.BLKB 



.BLKB 1 



.BLKB 
.BLKB 

10. 

8. 

5. 



CYLINDERS CROSSED COUNT 

CURRENT CYLINDER 

CURRENT FAIRNESS COUNT 

FAIRNESS COUNT LIMIT 

DISK DIRECTION (HIGH BIT 1=0UT) 

DEVICE NAME FOR ACCOUNTING 

UNIT NUMBER FOR ACCOUNTING 

CACHE STATUS BITS 

CACHE PARTITION PCB ADDRESS 

CACHE STATISTICS BUFFER ADDRESS (BIAS) 

CACHE EXTENT DESCRIPTOR LISTHEAD 

CACHE VIRTUAL EXTENT SIZE 

CACHE READAHEAD EXTENT SIZE 

CACHE DIRECTORY EXTENT SIZE 

CACHE LOGICAL EXTENT SIZE 

CACHE OVERLAY EXTENT SIZE 

CACHE STATUS BYTE 2 

LENGTH OF THE UCB EXTENSION 

DEFAULT FAIRNESS COUNT LIMIT 

DEFAULT SOFT ERROR LIMIT 

DEFAULT HARD ERROR LIMIT 



CACHE STATUS BITS IN X.CSTS 

XC.ENA='B'200 
XC.ACT='B'100 
XC.DFR='B'040 

XC.DIR='B'020 
XC.OVR='B'010 
XC.DAT='B'004 
XC.L0G='B'002 
XC.RDA='B'001 

CACHE STATUS BITS IN X.CST2 

X2.DEA='B'l 



AUTOCACHE ENABLED (1=YES) 

CACHE ACTIVE FOR DEVICE (1=YES) 

TEMPORARY FILE WRITE DEFERRED SUPPORT (1=YES) 

CACHE DIRECTORY REQUESTS (1=YES) 
CACHE OVERLAY REQUESTS (1=YES) 
CACHE VIRTUAL REQUESTS (1=YES) 
CACHE LOGICAL REQUESTS (1=YES) 
CACHE VIRTUAL READ AHEAD (1=YES) 



; CACHE IS CURRENTLY BEING DEACTIVATED (1=YES) 
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DEFINE CACHE MAXIMUM AND DEFAULT EXTENT SIZES 



XX.MAX='B'127. 

XX.DAT='B'5. 
XX.RDA='B'5. 
XX.DIR='B'l. 
XX.LOG='B'l. 
XX.0VR='B'4. 



MAXIMUM EXTENT SIZE 

DEFAULT VIRTUAL EXTENT SIZE 
DEFAULT READAHEAD EXTENT SIZE 
DEFAULT DIRECTORY EXTENT SIZE 
DEFAULT LOGICAL EXTENT SIZE 
DEFAULT OVERLAY EXTENT SIZE 



DEFINE OFFSETS FOR DISK MSCP CONTROLLERS (SECOND UCB EXTENSION) 



CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS 



.=0 






X.MLUN: 


'L' 


.BLKW 1 


X.UNFL: 


'L' 


.BLKW 1 




.6LKW 2 


X.UNTI: 


'L' 


.BLKW 4 


X.MEDI: 


•L" 


.BLKW 2 


X.SHUN: 


•L- 


.BLKW 1 


X.SHST: 


•L' 


.BLKW 1 


X.TRCK: 


'L- 


.BLKW 1 


X.GRP:' 


L". 


BLKW 1 


X.CYL:' 


L'. 


BLKW 1 


X.USVR: 


■L' 


.BLKB 1 


X.UHVR: 


•L' 


.BLKB 1 


X.RCTS: 


'L' 


.BLKW 1 


X.RBNS: 


'L' 


.BLKB 1 


X.RCTC: 


•L' 


.BLKB 1 



MULTI-UNIT CODE 
UNIT FLAGS 
RESERVED 
UNIT IDENTIFIER 
MEDIA IDENTIFIER 
SHADOW UNIT 
SHADOW UNIT STATUS 
UNIT TRACK SIZE 
UNIT GROUP SIZE 
UNIT CYLINDER SIZE 
UNIT SOFTWARE VERSION 
UNIT HARDWARE VERSION 
UNIT RCT TABLE SIZE 
UNIT RBN 'S / TRACK 
UNIT RCT COPIES 



CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS" END 
PACKETS 



X.UNSZ:'L'.BLKW 2 


;UNIT SIZE 


X.VSERr'L'.BLKW 2 


; VOLUME SERIAL NUMBER 


X.DUSZ='B'. 


;SIZE OF DISK MSCP CO 


-IF NB TTDEF 





System Data Structures and Symbolic Definitions C-81 



UCBDF$ 



; TERMINAL DRIVER DEFINITIONS 



."U.BUF 

U.TAPR:'L' 

U.TUX:'L' 

U.TSTA:'L' 

U.UIC:'L' 

U.TFRq:'L' 

U.TFLK:'L' 

U.TCHP:'L' 

U.TCVP:'L' 

U.TTYP:'L' 

U.TMTI:'L' 

U.TTAB:'L' 



.BLKW 1 

.BLKW 4 
.BLKW 1 



.BLKW 
.BLKW 
.BLKB 
.BLKB 
.BLKB 
.BLKB 
.BLKW 



U.TECO:'L' .BLKB 1 



U.TBSZ:'L' 

U.TLPP:'L' 

U.TST5:'L' 

U.TST6:'L' 

U.TIXL:'L' 

U.ACB:'L' 

U.AFLG:'L' 

U.ADMA:'L' 



.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
BLKW 1 
.BLKW 1 
.BLKW 1 



LAT Host Support 



U.LINS: 
U.CREN: 

U.SRVN: 
U.SESN: 
U.SLSZ: 

U.RSBB: 
U.RBHA: 
U.RSDV: 

U.TRLH: 
U.TRSC: 



.BLKB 1 
.BLKB 1 



L' .BLKW 1 

L' .BLKB 1 

L' .BLKB 1 

L' .BLKW 1 

L' .BLKW 1 

L' .BLKW 1 

L' .BLKW 1 

L' .BLKW 1 



U.CCBA:'L' .BLKW 1 



APR VALUE FOR START OF UCBX 

POINTER TO UCB EXTENSION (UCBX) 

STATUS qUADRUPLE-WORD 

DEFAULT UIC 

FORK REQUEST WORD 

FORK LIST LINK WORD 

CURRENT HORIZONTAL POSITION 

CURRENT VERTICAL POSITION 

TERMINAL TYPE 

MODEM TIMER 

IF 0: U.TTAB+1 IS SINGLE-CHARACTER TYPE- AHEAD 

BUFFER. CURRENTLY EMPTY 
IF ODD: U.TTAB+1 IS SINGLE-CHARACTER TYPE- AHEAD 

BUFFER AND HOLDS A CHARACTER 
IF NON-0 AND EVEN: POINTER TO MULTI-CHARACTER 

TYPE-AHEAD BUFFER 
THE NEXT TWO OFFSETS OVERLAP U.TTAB WHEN THE 
TYPEAHEAD BUFFER IS IN SECONDARY POOL 
ECHO BUFFER FOR DMA OPERATIONS WHEN UCBX IS 
IN SECONDARY POOL AND THUS NOT MAPPED BY A UMR 
TYPEAHEAD BUFFER SIZE 
LINES PER PAGE 
ADDITIONAL STATUS BITS 
EXTENDED I/O STATUS WORD 
I/O PACKET EXTENSION LISTHEAD 
ANCILLARY CONTROL DRIVER BLOCK ADDR 
ANCILLARY CONTROL DRIVER FLAGS WORD 
ANCILURY CONTROL DRIVER DMA BUFFER 



; STATUS/CONTROL INFORMATION 

;LINK STATUS 

; TRANSMIT CREDITS COUNTER AND STATUS EXTENSION 
; SERVER/CIRCUIT IDENTIFICATION 

: SERVER NUMBER 

; SESSION NUMBER 

; MAXIMUM SLOT SIZE ON XMT 
:PARAMETRS ON RECEIVE DATA 

; RECEIVE SLOT BIAS 

; RECEIVE SLOT HEADER VIRTUAL 

; RECEIVE DATA VIRTUAL 
;XMT INTERMEDIATE BUFFER CHAIN 

;XMT LISTHEAD ADDRESS 

;XMT REMAINED BYTES IN BUFFER 
; VIRTUAL CIRCUIT CCB 

;CCB ADDRESS (IN POOL) 



LINK STATUS WORD IN U.LINS 
UL.TRS='B'l 
UL.TDA='B'2 
UL.LST='B'4 



1-XMT STOPPED. 0-NOT 

>255 CHAR. FOR SLOT. HOLD IT. 

1-XMT DATA AVAIL, 0-NOT 

DATA IN XMT QUEUE (SET BY PORT) 

1-LINE STOPPED, 0-NOT 
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UL.RDA='B'10 
UL.ECH='B'20 
UL.RSS='B'100 

UL.LEN='B'200 



LINE STOPPED BY USER (XOFF 

CAME FROM REMOTE TERMINAL) 

1-RCV DATA AVAIL. 0-NOT 

DATA IN RCV QUEUE (SET BY PROC) 

BUFFER ALLOCATION FAILURE 

FOR 1 ECHO CHARACTER 

1-RCV STOPPED. 0-NOT 

RCV STOPPED BY TTDRV ON RECEIVE 

IF NO RESOURCES AVAILABLE 

1-LINK ENABLE, 0-NOT 

TOGGLED BY START/STOP LINK CALL 



LINK STATUS EXTENSION (HIGH 4 BITS OF U.CREN) 



LE.HIP='B'20 



LE.TDC='B'40 



LE.CIP="B'100 



DEFINE BITS IN STATUS WORD 1 



INPUT STATU 



S1.RST= 


B'l 


SI. ESC" 


B'2 


S1.RSP= 


B'4 


S1.PTH= 


B'lO 


Sl.RNE" 


B<20 


S1.TSY= 


B'40 


S1.0BY= 


B'lOO 


S1.IBY= 


B'200 


S1.DPR= 


B'400 


S1.DEC= 


B'lOOO 


SI . IBF= 


B'2000 


S1.DS1= 


B'40OO 


S1.RES= 


B' 10000 


S1.RNF= 


B' 20000 


S1.TNE= 


B' 40000 


S1.USI= 


B' 100000 



; HANGUP IN PROGRESS. SET IF LHMTIM IS 
; CALLED BEFORE ALL DATA HAS BEEN SENT 
; TRANSMIT DATA COMPLETE. BIT SET DURING 
; .HIP WHEN ALL DATA HAS BEEN SENT 
; CONNECT IN PROGRESS. SET WHEN A CONNECTION 
;T0 A TERMINAL SERVER IS PENDING. 
(U.TSTA) 



READ WITH SPECIAL TERMINATORS IN PROGRESS 

ESCAPE SEQUENCE IN PROGRESS 

READ WITH SPECIAL PROCESSING 

PASS THRU IS CURRENTLY ACTIVE 

ECHO SUPPRESSED 

TERMINAL OUTPUT SYNC IS CURRENTLY ENABLED 

OUTPUT BUSY 

INPUT BUSY 

DEFER PROCESSING OF CHAR. IN U.TECB 

DEFER ECHO OF CHAR. IN U.TECB 

BUFFERED INPUT IN PROGRESS 

INPUT PROCESSING DISABLED 

ESC. SEQ PROCESSING IS ENABLED FOR THE CURRENT READ 

READ NO FILTER IS ACTIVE (EDIT CHARS. ARE DISPLAYED) 

TERMINATOR NO ECHO 

UNSOLICITED INPUT IN PROGRESS 
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DEFINE BITS IN STATUS WORD 2 (U.TSTA+2) 



OUTPUT STATUS 



S2 


RCU= 


B 


1 


S2.WRA= 


B 


6 


S2 


WRB= 


B 


2 


S2 


WAL= 


B 


10 


S2.BRQ» 


B 


20 


S2.SRq= 


6 


40 


S2 


ORq= 


B 


100 


S2 


IRQ^ 


B 


200 


S2 


FLF= 


B 


400 


S2 


ELF= 


B 


1000 


S2 


CR=M 


J '2000 


S2 


OBF= 


B 


4000 


S2 


PCU= 


B 


10000 


S2 


BEL= 


B 


20000 


S2 


.CTO= 


B 


40000 


S2 


CTS= 


B 


100000 



RESTORE CURSOR (MUST = TF.RCU) 

CONTEXT FOR WRAP-AROUND 

LOW BIT IN S2.WRA BIT PATTERN 

WRITE PASS ALL (MUST = TF.WAL) 

BREAK-THROUGH-WRITE REQUEST IN QUEUE 

SPECIAL REQUEST IN QUEUE 

(10. ATT, lO.DET. SF.SMC) 

OUTPUT REQUEST IN QUEUE (MUST = Sl.OBY) 

INPUT REQUEST IN QUEUE (MUST = Sl.IBY) 

FORCE LINEFEED BEFORE NEXT ECHO 

EAT A LINEFEED (IGNORE A LEADING LF ON OUTPUT) 

TRAILING CR REQUIRED ON OUTPUT 

BUFFERED OUTPUT IN PROGRESS 

POSITION CURSOR BEFORE WRITE 

BELL PENDING 

OUTPUT STOPPED BY CTRL-O 266. 

OUTPUT STOPPED BY CTRL-S 



DEFINE BITS IN STATUS WORD 3 (U.TSTA+4) 



TERMINAL OPERATION CHARACTERISTICS 



SS.ACR's 
S3.TAB= 
S3.CTC= 
S3.RAL= 
S3.NEC= 
S3.TSY= 
S3.8BC= 
S3.FDX= 
S3.MHE= 
S3.ICE= 
S3.TME= 
S3.PTH= 
S3.RES= 
S3.PPT= 
S3.RUB- 



'1 

'2 

'4 

'10 

'20 

•40 

■100 

'200 

'400 

'1000 

■2000 

■4000 

■10000 

■20000 

'40000 



WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED 

TYPE-AHEAD BUFFER ALLOCATION REQUESTED 

TERMINAL WANTS CLI TO HAVE 'C NOTIFICATION 

TERMINAL IS IN READ-PASS-ALL MODE 

NO ECHO 

TERMINAL SYNC 

PASS 8 BITS ON INPUT 

LINE IS IN FULL DUPLEX MODE 

NOTIFY ATTACHED TASK OF MODEM HANG-UP 

INPUT COUNT STATE ENABLED 

TERMINAL MANAGEMENT MODE ENABLED 

PASS THROUGH REQUESTED 

TASK WANTS ESCAPE SEQUENCES 

TERMINAL HAS PRINTER PORT 

RUBOUT SEQUENCE IN PROGRESS (NON-SCOPE) 
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DEFINE BITS IN STATUS WORD 4 (U.TSTA+6) 



TERMINAL ATTRIBUTE CHARACTERISTICS 



S4.HFL= 
S4.VFL= 
S4.HFF= 
S4.HHT= 
S4.DL0= 
S4.HSY= 
S4.ANI= 
S4.AV0= 
S4.BLK= 
S4.DEC= 
S4.EDT= 
S4.RGS= 
S4.SFC= 
S4.ABD== 



•B'7 

•B'lO 

'B'20 

■B'40 

'B'lOO 

'B*200 

•B'4O0 

•B'lOOO 

■B'2000 

■B'4000 

•B' 10000 

'B' 20000 

•B '40000 

'B' 100000 



HORIZONTAL FILL REQUIREMENT 

VERTICAL FILL REQUIREMENT 

HARDWARE FORM-FEED PRESENT 

HARDWARE HORIZONTAL TAB PRESENT 

DIAL-OUT LINE (IMPLIES U2.RMT) 

HOST/TERMINAL SYNCHRONIZATION ENABLED (1=YES) 

ANSI CRT TERMINAL 

VTIOO-FAMILY TERMINAL DISPLAY 

BLOCK MODE TERMINAL 

DIGITAL CRT TERMINAL 

TERMINAL HAS LOCAL EDITING FUNCTIONS 

TERMINAL SUPPORTS REGIS GRAPHICS 

TERMINAL SUPPORTS SOFT CHARACTERS (DRCS) 

AUTO-BAUD SPEED DETECTION ENABLED 



DEFINE BITS IN STATUS WORD U.TST5 
ADDITIONAL STATUS CHARACTERISTICS 



S5.SWl='B'l 



S5.TMM= 
S5.X0F= 
S5.X0N= 
S5.HPC= 
S5.HP0= 
S5.0XF= 
S5.ITI= 
S5.DEP= 
S5.DMA= 
S5.CLN= 
S5.RP0= 
S5.VER= 

S5.BCC= 

S5.DA0= 



B'2 

B'4 

B'lO 

B'14 

B'20 

B'40 

B'lOO 

B'200 

B'400 

B'lOOO 

B'2000 

B' 10000 

B' 20000 

B' 40000 



S5.ABP='B' 100000 



FIRST TERMINAL MANAGEMENT SWITCH 

CHARACTER HAS BEEN SEEN 

TERMINAL IN TERMINAL MANAGEMENT MODE 

SEND AN XDFF AT FIRST OPPORTUNITY 

SEND AN XGN AT FIRST, OPPORTUNITY 

OUTPUT OF HIGH PRIORITY CHARACTERS REQUESTED 

HIGH PRIORITY OUTPUT IN PROGRESS 

XOFF HAS BEEN OUTPUT 

IMMEDIATE TIMEOUT ON INPUT 

DISABLE ERROR PROCESSING 

TERMINAL SUPPORTS DMA 

7-BIT CHARACTER LENGTH 

READ W/PROMPT OUTPUT IN PROGRESS 

LAST CHAR. IN TYPE- AHEAD BUFFER 

HAS PARITY ERROR 

LAST CHAR. IN TYPE- AHEAD BUFFER 

HAS FRAMING ERROR 

LAST CHAR. IN TYPE-AHEAD BUFFER 

HAS DATA OVERRUN ERROR 

NOTE - THE 3 BITS ABOVE MUST CORRESPOND 

TO THE RESPECTIVE ERROR FLAGS IN THE 

HARDWARE RECEIVE BUFFER 

AUTO-BAUD SPEED DETECTION IN PROGRESS 



DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6 



S6.LAT='B'l 
S6.EI0='B'4O0 
S6.RLU='B'1000 
S6.RDI='B' 100000 



TERMINAL IS A LAT APPLICATION TERMINAL 
READ WAS AN EXTENDED I/O 

READ WITH LOWER CASE TO UPPER CASE CONVERSION 
READ WITH DEFAULT INPUT 
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.ENDC 



VIRTUAL TERMINAL UCB DEFINITIONS 



.=U.UNI 


T 






U.DCNT: 


•L' 


.BLKB 


1 


.=U.BUF 








U.RPKT: 


•L' 


.BLKW 




U.WPKt: 


'L' 


.BLKW 




U.IAST: 


'L' 


.BLKW 




U.OAST: 


'L' 


.BLKW 




U.AAST: 


'L' 


.BLKW 






.IF NB 


TTDEF 


.IIF NE U.AAST+2-U.UIC 




.ENDC 




.=U.AAST+4 






U.PTCB: 


'L' 


.BLKW 


1 



; OFFSPRING WITH THIS AS TI: 

CURRENT OFFSPRING READ I/O PACKET 
CURRENT OFFSPRING WRITE I/O PACKET 
INPUT AST ROUTINE ADDRESS 
OUTPUT AST ROUTINE ADDRESS 
ATTACH AST ROUTINE ADDRESS 



.ERROR : ADJACENCY ASSUMED 



CONSOLE DRIVER DEFINITIONS 



.=U.BUF+2 
U.CTCB:'L' 
U.COTq:'L' 
U.RED2;'L' 



.BLKW 
.BLKW 
.BLKW 



; PARENT TCB ADDRESS 



ADDRESS OF CONSOLE LOGGER TCB 
I/O PACKET LIST QUEUE 
REDIRECT UCB ADDRESS 



.PSECT 



DEVICE TABLE STATUS DEFINITIONS 

DEVICE CHARACTERISTICS WORD 1 (U.CWl) DEVICE TYPE DEFINITION BITS. 



RECORD ORIENTED DEVICE (1=YES) 

CARRIAGE CONTROL DEVICE (1=YES) 

TERMINAL DEVICE (1=YES) 

FILE STRUCTURED DEVICE (i=YES) 

SINGLE DIRECTORY DEVICE (1=YES) 

SEQUENTIAL DEVICE (1=YES) 

MASS STORAGE DEVICE (1=YES) 

USER MODE DIAGNOSTICS SUPPORTED (1=YES) 

MASSBUS CONTROLLER (IIM COMPATIBILITY ONLY) 

UNIT ON EXTENDED 22-BIT UNIBUS CNTROLER (1=YES) 

UNIT SOFTWARE WRITE LOCKED (1=YES) 

INPUT SPOOLED DEVICE (1=YES) 

OUTPUT SPOOLED DEVICE (1=YES) 

PSEUDO DEVICE (1=YES) 

DEVICE IS MOUNTABLE AS COM CHANNEL (1=YES) 

DEVICE IS MOUNTABLE AS Fll DEVICE (1=YES) 

DEVICE IS MOUNTABLE (1=YES) 



DV.REC= 


B'l 


DV.CCL= 


B'2 


DV.TTY= 


B'4 


DV.DIR= 


B'lO 


DV.SDI= 


B'20 


DV.SQD= 


B'40 


DV.MSD= 


B'lOO 


DV.UMD= 


B'200 


DV.MBC= 


B'400 


DV.EXT= 


B'400 


DV.SWL= 


B'lOOO 


DV.ISP= 


B'2000 


DV.OSP= 


B'4000 


DV.PSE= 


B' 10000 


DV.CaM= 


B- 20000 


DV.F11= 


B' 40000 


DV.MNT= 


B' 100000 
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TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



UNIT IS A MULTIPLEXER (1=YES) 

UNIT IS A DJll (1=YES) 

UNIT IS REMOTE (1=YES) 

UNIT HANDLES HARDWARE FORM FEEDS (1=YES) 

OLD NAME FOR U2.HFF 

DON'T ECHO SOLICITED INPUT (1;=YES) 

UNIT IS A CRT (1=YES) 

UNIT GENERATES ESCAPE SEQUENCES (1=YES) 

USER" LOGGED ON TERMINAL (0=YES) 

UNIT IS A SLAVE TERMINAL (1=YES) 

UNIT IS A DZll (1=YES) 

TERMINAL IS IN HOLD SCREEN MODE (1=YES) 

MCR COMMAND AT. BEING PROCESSED (1=YES) 

UNIT IS A PRIVILEGED TERMINAL (1=YES) 

UNIT IS A LA30S TERMINAL (1=YES) 

UNIT IS A VT05B TERMINAL (1=YES) 

LOWER CASE TO UPPER CASE CONVERSION (0=YES) 



OVERRIDE CLI INDICATOR 

CLI INDICATOR BITS 

TERMINAL DISABLED SINCE CLI ELIMINATED 

NO BROADCAST 

CONTINUATION LINE IN PROGRESS 

COMMAND IN PROGRESS 

SERIAL COMMAND RECOGNITION ENABLED 

TTDRV SHOULD SEND KILL PKT ON CNTRL/C 



U2.DH1= 


B' 100000 


U2.DJ1= 


B' 40000 


U2.RMT= 


B' 20000 


U2.HFF= 


B ' 10000 


U2.L8S= 


B' 10000 


U2.NEC= 


B'4000 


U2.CRT= 


B'2000 


U2.ESC= 


B'lOOO 


U2.L0G= 


B'400 


U2.SLV= 


B'2O0 


U2.DZ1= 


B'lOO 


U2.HI,D= 


B'40 


U2.AT.= 


B'20 


U2.PRV= 


B'lO 


U2.L3S= 


B'4 


U2.VT5= 


B'2 


U2.LWC= 


B'l 



BIT DEFINITIONS FOR U.MUP 



UM.OVR= 
_UM.CLI= 
UM.DSB= 
UM.NBR= 
UM.CNT= 
UM.CMD= 
UM.SER= 
UM.KIL= 



■ B'l 

'B'36 

"B'200 

<B'400 

'B'lOOO 

'B'2000 

>B'4000 

'B'lOOiDO 



(,E: 



-yO^ 



cP 



RH11-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



;UNIT IS A RS04 (1=YES) 
RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



U2.R04='B' 100000 

+ 



;UNIT IS A 7 CHANNEL DRIVE (1=YES) 
TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS 



U2.7CH='B' 10000 

+ 



U3.UPC='B' 20000 
U3.PAR='B '40000 
U3.0PA='B' 100000 



UPCASE OUTPUT FLAG 

PARITY GENERATION AND CHECKING 

PARITY SENSE (1=0DD PARITY) 



VIRTUAL TERMINAL 3RD CHARACTERISTICS WORD DEFINITIONS 



U3.FDX='B'l 
U3.DBF='B'2 
U3.RPR='B'4 



FULL DUPLEX MODE (1=YES) 

INTERMEDIATE BUFFERING DISABLED (1=YES) 

READ W/PROMPT IN PROGRESS (1=YES) 
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TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS 



U4.CR='B'100 



:LOOK FOR CARRIAGE RETURN 



UNIT CONTROL PROCESSING FUG DEFINITIONS 



UC.ALG='B"200 

UC.NPR='B'10O 

UC.QUE='B'40 

UC.PWF='B'20 

UC.ATT='B'10 

UC.KIL='B'4 

UC.LGH='B'3 

I- 
UNIT STATUS BIT DEFINTIONS 



US.BSY='B'200 

US.MNT='B'100 

US.F0R='B'40 

US.MDM='B'20 

US.PWF='B'10 



BYTE ALIGNMENT ALLOWED (1=N0) 
DEVICE IS AN NPR DEVICE (1=YES) 
CALL DRIVER BEFORE QUEUING (1=YES) 
CALL DRIVER AT PGWERFAIL ALWAYS (1=YES) 
CALL DRIVER ON ATTACH/DETACH (1=YES) 
CALL DRIVER AT I/O KILL ALWAYS (1=YES) 
TRANSFER LENGTH MASK BITS 



UNIT IS BUSY (1=YES) 

UNIT IS MOUNTED (0=YES) 

UNIT IS MOUNTED AS FOREIGN VOLUME (1=YES) 

UNIT IS MARKED FOR DISMOUNT (1=YES) 

POWERFAIL OCCURED (1=YES) . 



CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS 



US.ABO='B'l 
US.MDE='B'2 



;UNIT IS MARKED FOR ABORT IF NOT READY (1=YES) 
;UNIT IS IN 029 TRANSLATION NODE (1=YES) 



FILES- 11 DEPENDENT UNIT STATUS BITS 



US.WCK='B'10 

US.SPU='B'2 

US.W='B'l 



WRITE CHECK 'ENABLED (1-YES) 
UNIT IS SPINNING UP (1=YES) 
VOLUME VALID IS SET (1=YES) 



TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS 



US.CRW='B'4 
US.DSB='B'2 
US.OIU='B'l 



UNIT IS WAITING FOR CARRIER (1=YES) 

UNIT IS DISABLED (1=YES) 

OUTPUT INTERRUPT IS UNEXPECTED ON UNIT (1=YES) 



LPSll DEPENDENT UNIT STATUS BIT DEFINITIONS 



US.FRK='B'2 
US.SHR='B'l 



;FORK IN PROGRESS (1=YES) 

; SHAREABLE FUNCTION IN PROGRESS (0='B'YES) 



ANSI MAGTAPE DEPENDANT UNIT STATUS BITS 
US.LAB='B'4 ; UNIT HAS LABELED TAPE ON IT (1=YES) 
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UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS 



US.aFL= 

US.RED^' 

US.PUB=' 

US.UMD= 

US.PDF=' 

US.MUN=' 

US.TRN=' 

US.SIO=' 

; + 

: MAGTAPE 



= "B' 
= 'B' 
= ■8' 
= "B' 
= 'B' 
= 'B' 
= 'B' 
= 'B' 



1 

2 

4 

10 

20 

40 

100 

200 



UNIT OFFLINE (1=YES) 

UNIT REDIRECTABLE (0=YES) 

UNIT IS PUBLIC DEVICE (1=YES) 

UNIT ATTACHED FOR DIAGNOSTICS (1=YES) 

PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY (1=YES) 

MULTI-UNIT FLAG 

UNIT TRANSITION HAS OCCURRED (1=YES) 

STALL I/O TO UNIT (1=YES) 



DENSITY SUPPORT DEFINITION IN U.CW3 



UD.UNS='B'0 
UD.200='B'l 
UD.556='B'2 
UD.800='B'3 
UD.160='B'4 
UD.625='B'5 
UD.8K='B'6 



UNSUPPORTED 






200BPI. 


7 TRACK 






556BPI. 


7 TRACK 






800BPI . 


7 OR 9 TRACK 




1600BPI . 


9 TRACK 






6250BPI , 


9 TRACK 






8K BPI - 


SERIAL , 


SERPENTINE 


RECORDING 



.MACRO 

.ENDM 

.EHDM 



UCBDF$.X.Y.Z,A 
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Appendix D 



Common Error Code Definitions 

This appendix lists the following: 

1. Facility-independent error code definitions 

2. Standard Bugcheck formats for facility-defined error codes 



Common (facility independent) error code definitions 



SST type errors - Major error code 1 

BE. ODD = OOOiOO Odd address or other trap four 

BE.SGF = 000102 Segment fault 

BE.BPT = 000104 Breakpoint or T-bit trap 

BE. IDT = 000106 lOT instrtuction 

BE.ILI - 000110 Illegal instruction 

BE.EMT = 000112 EMT instruction 

BE.TRP = 000114 Trap instruction 

BE.STK = 000116 Stack overflow 

Internal inconsistency errors - error code 2 

BE.NPA = 000200 Task with no parent aborted 

BE.SGN - 000201 Feature not included in system 

BE.2FR = 000202 Double fork 

BE.ISR = 000203 Int. service routine clobbered reg. 

BE.FHW = 000204 Fatal hardware error 

BE.CSR = 000205 Device CSR disappeared 

BE. IDC = 000206 Internal database consistency error 

BE. AC? = 000207 AC? task aborted 

BE.HSP = 000210 Header subpacket problem 

BE.NCT = 000211 No current task 

System pool related errors - error code 3 

BE.NPL = 000300 No pool for operation 

BE.DDA = 000301 Double deallocation 

BE.SIZ = 000302 Size of block invalid 

BE.BAK = 000303 Deallocated block below pool 

BE.POV = 000304 Deallocation overlaps end of pool 

BE.FSI = 000306 Allocation - fragment size invalid 
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Group global event flag errors - error code 4 
BE.GGF = 000400 Task locked to non-existent flags 

Standard bugcheck format facility code definitions 

P/OS keyboard handler - Major facility code 1 
BF.PKS = 000100 P/OS Keyboard handler 

I/O driver subsystem - facility code 2 
BF.TTD = 000200 Terminal driver 



Executive components - facility code 3 



BF.EXE 
BF.XDT 
BF.MP 



000300 
000301 
000302 



Exec - General and miscellaneous 
Exec - Executive debugging tool 
Exec - Multiprocessing 



BF.POL 
BF.ERR 
BF.INT 
BF.INI 
BF.DVI 
BF.PAR 
BF.XIT 
BF.qiO 
BF.OPT 
BF.ACC 
BF.KAS 
BF.DIR 
BF.SAN 



BF.UP 



mP specific type errors 

BE.NDS = 100100 Init failure - d-space not loaded 

BE.NCK = 100200 clock not available 

BE.URM = 100300 Fork to offline UMIBUS run 

BE.WTL = 100400 Attempt to walk through lock 

BE. UNO = 100500 Attempt to unlock not by owner 

BE.ILC = 100600 Illegal lock count value 

BE.LNS = 100700 Lock not locked 

BE.OCP = 101000 At entry another CPU showed ownership 

BE.MLK = lOilOO Attempt to exit multiple lock 

BE.HIN = 101200 No reason for interprocessor int. 

BE.UNP = 101300 Some UNIBUS run not connected 

= 000303 Exec - Pool handling routines (CORAL) 

= 000304 Exec - hardware error processing subsystem 

= 000305 Exec - Internal consistence checking routine 

= 000306 Exec - INITL - initilization module 

= 000307 Exec - DVINT common interrupt handler 

= 000310 Exec - Parity memory support 

= 000311 Exec - task exit/abort procesing 

= 000312 Exec - QIO directive 

= 000313 Exec - Seek optimization 

= 000314 Exec - System resource accounting 

= 000315 Exec - Kemal AST support 

= 000316 Exec - Miscellaneous directives 

= 000317 Exec - Crash with sanity timer message 



P/OS startup task - facility code 4 
= 000400 P/OS startup task 
UP specific error messages 



BE. INI = 100100 

BE.SPl = 100200 

BE.SP2 = 100300 

BE.FNF = 100400 



Can't install task CBOOT 
Can't Spawn task CBOOT 
Can't Spawn task CHAIN 
Required file not found 



Non-standard bugcheck format facility definitions 

P/OS terminal subsystem - Major facility code 1 
BF.PTS = 100400 P/OS terminal subsystem 



D-2 Common Error Code Definitions 



Index 



ABODFS, C-3 
ACNDF$, C-5 
/ACT, 2-3, 2-5 
Active task 

address of TCB, 3-15 

AST queue, 3-17 

attribute bits, 3-16 

blocking bits, 3-16 

name, 3-15 

partition, 3-15 

receive-by-reference queue, 3-18 

receive queue, 3-17 

state bits, 3-16 

task image, 3-15 
Active task dump, 3-15 

AST queue, 3-15 

Offspring Control Block, 3-15 

receive-by-reference queue, 3-15 

receive queue, 3-15 
/ADV, 2-3, 2-5 
/ALL, 2-4, 2-5 
All devices switch 

See /ADV 
Analysis listings, 3-1 to 3-45 

interpreting, 4-1 
Analysis routines switch 

See /ALL 
Analysis switches, 2-3 to 2-7 
ANALYZE/CRASH_DUMP command, 1-7 

error messages, A-1 

examples, 2-20 

format, 2-11 

input to, 2-12 

qualifiers, 2-12 to 2-20 

specification, 2-12 
Assign table dump, 3-1, 3-14 



Assign table dump (cont'd.) 
logical device names, 3-14 
physical device names, 3-14 

/ATL, 2-3, 2-5 

B 

Binary output file size switch 

See /MEMSIZ 
/BL, 2-8 
Block number switch 

See /BL 
Bugcheck facility, 1-4 

c 

/CACHE, 2-4, 2-5 
Cache dump, 3-44 
Cache memory, 3-44 
Cache memory switch 

See /CACHE 
CDA 

analysis listings, 3-1 to 3-45 

function, 1-1 

input to, 1-5 

messages, A-1 

running, 1-6 

as installed task, 1-7 
as uninstalled task, 1-7 

switches, 2-3 to 2-11 
CDA conunand line, 2-1 to 2-11 

binary file, 2-2 

crash input file, 2-3 

default, 2-10 

format, 2-1 

list file, 2-1 

symbol file, 2-2 
/CU, 2-4, 2-5 
CLI parser block dump, 3-24 



Index-1 



CLKDF$, C-12 

Clock queue dump, 3-41 

Clock queue switch 

See /CLQ 
/CLQ, 2-4, 2-6 
Command line interpreter switch 

See /CLI, /CPB 
Common Block Directory dump, 3-29 
/CPB, 2-4, 2-5 
Crash 

cause 

determining, 4-1 
HALT, 1-5 

HALT instruction, 1-4 
infinite loop, 1-4, 1-5 
processor trap, 1-4 
restart procedure, 1-4 
Crash dump 

obtaining, 1-4 
Crash Dump Analyzer 

See CDA 
Crash dump binary file, 1-5, 1-6, 2-2 
Crash dump device, 1-1, 1-5 

displaying current one, 1-3 

invalid, 1-5 

limitations, 1-2 

loadable, 1-2 

restrictions, 1-2 

selecting, 1-3 

specifying, 2-2 

valid for RSX-llM/M-PLUS system, 1-2 

valid for Micro/RSX system, 1-2 

valid for pregenerated RSX-llM-PLUS 
system, 1-2 
Crash dump driver, 1-1 

procedure, 1-5 

unloading, 1-4 
Crash dump listing 

See also Analysis listings 

interpreting, 4-1 to 4-3 
mapping data, 4-1 
stack depth, 4-2 
Crash notification device, 1-1, 1-2, 1-5 
$CRAVL, 3-12, 3-36 
CTBDF$, C-14 
/CTL, 2-4, 2-6 

P 

/DCB,2-4, 2-6 
DCBDF$, C-15 
/DENS, 2-8 



/DEV, 2-4, 2-6 

Device 

fixed media, 1-5 

switches, 2-6 

valid crash dump, 1-2 

Device controller dump, 3-42 
common interrupt address, 3-42 
Controller Request Block, 3-43 
controller status, 3-43 
Controller Table, 3-42 

Device controller switch 
See /CTL 

Device information dump, 3-30 
control processing flags, 3-31 
device characteristics word, 3-31 
Device Control Block, 3-34 
I/O request packet, 3-34 
Status Control Block, 3-34 
terminal status word, 3-30 
UCB extension, 3-34 

Device names 
logical, 3-14 
physical, 3-14 

/DMP, 2-4, 2-6 

/DUMP, 2-4, 2-6 



EPKDF$, C-17 
Error log buffer 

address of, 3-14 
Error log packet dump, 3-1, 3-14 
Error messages, A-1 
EVNDFS, C-25 
Executive Debugging Tool 

See XDT 
Executive symbol table, 2-2, 2-14 
/EXIT, 2-8 
Exit switch 

See /EXIT 



F11DF$, C-28 

Function switches, 2-7 to 2-10 



Group Global Event Flag dump, 3-1 
Group global event flag dump, 3-14 

H 



/HDR, 2-4, 2-6 
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HDRDF$, C-32 
HWDDF$, C-34 

I 



ITBDF$, C-39 
K 



OLRDF$, C-49 
Output listing limit switch 
See /LIMIT 

P 



/KDS, 2-4, 2-6 
Kernel data space 

dump, 3-44 

switch 

See /KDS 
Kernel instruction space 

dump, 3-44 

switch 

See /KIS 
Kernel Mapping Register switch 

See /KMR 
Kernel stack dump, 3-1, 3-4 
/KIS, 2-4, 2-6 
/KMR, 2-8, 2-9 
KRBDF$, C-40 



LCbDFS, C-42 
/LIMIT, 2-8, 2-9 
/LINES, 2-8, 2-9 
Lines per page switch 

See /LINES 
LNMDF$, C-43 

Logical device assignments, 3-14 
Logical device names, 3-14 
Low core memory 

dump, 3-4 

labels, 3-5 
Low Core Memory Dump, 3-1 

M 

Memory 

cache, 3-44 
/MEMSIZ, 2-8, 2-9 
MTADF$, C-46 

N 

No spool switch 
See /-SP 

o ^^ 

Offset mode, 3-1 



/PAR, 2-4, 2-6 
Partition 

base address, 3-15 

name, 3-15 

PCB address, 3-15 

status flags, 3-26 
Partition Control Block, 3-26 

address, 3-24 

pointer to, 3-26 

switch 

See /PCB, /PAR 
Partition information dump 

attachment descriptor, 3-27 

individual, 3-26 

system, 3-24 

wait queue, 3-27 
/PCB, 2-4, 2-6 
PCBDF$, C-57 
Physical device names, 3-14 
Physical memory switch 

See /DUMP 
$PKAVL, 3-36 
PKTDF$, C-62 
/POOL, 2-4, 2-7 
Pool 

bit map, 3-12 

dump, 3-36 

free, 3-12 

largest fragment, 3-12 

number of unallocated fragments, 3-12 

secondary pool dump, 3-36 

size, 3-12 

smallest possible block, 3-12 

total free bytes, 3-12 
Pool statistics dump, 3-1, 3-12 
Processor Status Word, 3-2 
Program Counter, 3-2 



Q 



Qualifiers 

command, 2-12 to 2-14 
crash-input, 2-15 to 2-20 

R 



Register 
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Register (cont'd.) 
cache control, 3-2 
error, 3-2 
general, 3-2 

memory management, 3-2 
memory system error, 3-2 
page 

address, 3-2 

description, 3-2 
UNIBUS mapping, 3-2 
volatile, 3-1, 3-3 

See also Volatile registers 
Relative addresses, 3-1 



/SCB, 2-4, 2-6 
SCBDF$, C-69 
Secondary pool 

dump, 3-36 

switch 

See /SECPOL 
/SECPOL, 2-4, 2-7 
SHDDF$, C-72 
/-SP, 2-8, 2-9 
Stack pointer 

kernel, 3-2 
Stack pointer 

kernel, 3-4 

user, 3-2 
/STB, 2-2, 2-8, 2-10 
/STD, 2-4, 2-7 
$STKDP 

stack depth indicator, 4-2 
Switches 

analysis, 2-3 to 2-7 

function, 2-7 to 2-10 
/-SYS, 2-4, 2-7 
System 

device 

switches, 2-6 

information, 3-1 
switch 

See /-SYS 

pool 

dump, 3-36 
switch 

See /POOL 
System common, 3-5 

active task, 3-6 

alphabetized dump, 3-1, 3-10 

boot device, 3-6 



System common (cont'd.) 

dump 

See System common dump 

labels, 3-10 to 3-11 

network UlC, 3-6 

partition address, 3-6 

stack depth, 3-6 

stack depth indicator, 4-2 

system size, 3-6 

TCB address, 3-6 

UIC, 3-6 
System common dump, 3-1, 3-10 to 3-11 
System Task Directory 

dump, 3-36 

switch 

See /STD 



/TAL, 2-4, 2-7 
Tape density switch 

See /DENS 
/TAS, 2-4, 2-7 
/TASK, 2-4, 2-7 
Task Control Block switch 

See /ACT, /ATL 
Task data space 

switch 

See /TDS 
Task dump, 3-39 

window blocks, 3-39 
Task header 

sv^tch 

See/HDR 
Task header dump, 3-21 

Directive Status Word, 3-22 

File Control Block, 3-22 

Logical Unit Table, 3-22 

Page Description Register, 3-23 

swapping priority, 3-22 

window blocks, 3-22 
Task instruction space 

switch 

See /TIS 
Task virtual address space switch, 2-7 
/TCB, 2-4, 2-7 
TCB 

address of, 3-15, 3-18 

pointer to current, 3-5 
TCBDF$, C-74 
/TDS, 2-4, 2-7 
/TIS, 2-5, 2-7 
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/TSK, 2-4, 2-7 

u 

/UCB, 2-4, 2-6 
UCBDF$, C-78 

V 



Volatile registers, 3-1 
dump, 3-2 to 3-3 

X 



XDT, 1-4, 1-5, 1-6 
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Crash Dump Analyzer 

Reference Manual 

AA-JS13A-TC 



READER'S 
COMMENTS 



Your comments and suggestions are welcome and will help us in our 
continuous effort to improve the quality and usefulness of our documentation 
and software. 

Remember, the system includes information that you read on your terminal: 
help files, error messages, prompts, and so on. Please let us know if you have 
comments about this information, too. 

Did you find this manual understandable, usable, and well organized? Please make suggestions for 
improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



What kind of user are you? 



Programmer 



Nonprogrammer 



Years of experience as a computer programmer/user: 
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City 



Date- 
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or Country 
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